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1.1  Overview: 

The  objectives  in  the  design  of  the  HAARP  optics  were  as  follows: 

(i)  Variable  field  of  view,  from  180°  to  ~  10°,  with  telecentric  optics  so  as  to 

allow  the  use  of  narrow-band  interference  filters  (~  2.0  nra  bandwidth). 

(ii)  Interchangeable  filters  (5-position  filter  wheel). 

(iv)  Maximum  sensitivity  and  resolution. 

(v)  Minimum  vignetting. 

Normal  camera  lenses  have  large  ray  angles  to  the  principal  ray  throughout  their  optical 
path,  and  so  are  unsuitable  for  use  with  narrow-band  interference  filters  (sec  Figure  1.1).  The 
shift  of  transmission  wavelength  with  filter  angle  increases  as  the  angle  squared,  so  that  larger 
ray  angles  rapidly  requires  much  wider  filters.  To  overcome  this  problem,  telecentric  systems 
can  be  designed,  where  the  principal  ray  of  all  image-forming  cones  across  the  field  of  view 
cross  the  image  plane  parallel  to  the  optical  axis.  Thus  the  maximum  ray  angles  through  the 
filter  are  determined  only  by  the  F  number  of  the  lens. 

For  low-light-level  imaging,  it  is  desirable  to  operate  at  the  lowest  F  numbers  possible. 
Lower  F  numbers  mean  higher  ray  angles  through  the  filter,  and  so  require  widcr-band  filters. 
However  narrow-band  filters  arc  readily  available  at  much  larger  diameters  than  the  imaging 
detectors,  so  that  high  F  number  images  at  the  filter  can  be  re-imaged  to  low  F  number  images 
at  the  detector.  [The  Lagrange  Invariant  is  conserved:  r.sin  a  =  constant,  where  r  is  the 
image  size  and  a  is  the  half-angle  of  the  image-forming  cone.) 

Thus  the  philosophy  of  the  HAARP  optical  system  was  to  use  the  largest  diameter 
filters  readily  available  (<  4")  at  the  desired  bandwidths  (~  2.0  nm)  to  fill  the  filter  area  with  a 
higher  F  number  telecentric  image,  and  then  to  re-image  at  low  F  number  onto  the  detector.  In 
this  way  we  can  effectively  form  monochromatic  images  of  wide-angle  fields  (up  to  180®  fish- 
eye)  onto  a  25  mm  image  intensifier  cathode,  at  an  effective  F  numbers  as  low  as  FI. 2. 
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1.2  Fisheye  Lens  Considerations: 


Much  of  the  operation  of  the  HAARP  instrument  will  be  with  a  fisheye  lens  (180°  field 
of  view).  The  following  describes  properties  of  various  configurations  of  such  lenses: 

A  lens  that  covers  a  hemispherical  field  of  view  (180  degrees)  is  usually  called  a  fish-eye  lens.  These 
lenses  have  inherent  large  distortion  because  it  is  not  possible  to  form  an  image  of  a  hemi^heric  field  onto  a 
plane  without  distortion.  This  distortion  should  not  be  considered  as  an  abemttion,  but  a  necessary  result  of  the 
projection. 

There  are  five  projection  systems  that  have  been  used  in  fish-eye  lens  design.  If  the  angle  of  an 
incident  ray  from  an  infinite  object  is  o  and  the  coordinates  of  the  image  point  be  r(0),  then  the  projections  are 
as  follows  ( f  is  lens  focal  length); 

1.  r  =  f .  tan  0 

2.  r  =  2  r .  tan  (0/2) 

3.  r  =  f.0 

4.  r  =  f.sm0 

5.  r  =  2  f .  sin  ( 0/2) 

Projccuon  1  is  that  of  a  normal  camera  lens. 

Projection  2  is  called  stereographic  projection.  A  small  circle  on  the  hemiephere  with  its  center  at  the 
lens  is  projected  as  a  circle  on  the  image  plane,  but  the  diameter  of  a  circle  at  the  edge  of  the  image  (0  =  1 80°)  is 
2it  as  large  as  the  image  of  an  equally  large  circle  at  the  pole  (0  =  0°).  This  projection  is  similar  to  our 
psychological  perception  of  the  whole  sky. 

Projection  3  is  called  equidistant  projection,  and  is  preferred  for  measurements  of  zenith  and  azimuth 
angles  because  of  the  linear  relation  between  r  and  0.  However  the  image  of  a  small  circle  is  not  a  circle,  and  is 
approximately  elliptical  with  the  major  axis  aligned  azimulhally. 

Projection  4  is  called  orthographic  projection.  The  area  of  an  image  is  proportional  to  illumination  by 
the  object  on  a  plane  parallel  to  the  Him  surface. 

Projection  5  is  called  equisolid  projection,  and  the  solid  angle  dQ  is  proportional  to  the  corresponding 
area  of  the  image.  This  projection  is  prefened  for  measuring  rclauvc  areas  of  the  sky  (for  example,  %  sky 
covered  by  clouds). 

Almost  all  commercially  available  fish-eye  lenses  for  35  mm  and  medium  format 
cameras  are  of  the  equidistant  projection  type,  which  minimizes  contraction  of  the  image  near 
the  edges  of  the  field. 
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Figure  1.1:  Shows  a  ray  diagram  for  a  typical  fish-cyc  lens  with  F  number  equal  to  4.0 
The  cone  angle  at  the  center  of  the  image  is  *7.1°  about  the  principal  ray.  At  the  edge  of 
the  field  of  view  (image  diameter  =  70  mm),  the  cone  angle  is  only  ±4.0®  about  the 
principal  ray;  the  decrease  from  ^7.1®  is  indicative  of  the  vignetting  of  the  lens  at  large 
field  angles.  At  the  edge  of  the  field,  the  image-fomiing  cone  spans  a  range  of  angles  from 
17.3® -25.3®  to  the  principal  axis. 

Clearly  it  is  not  px)ssible  to  use  a  narrow-band  interference  filter  in  this  situation,  as 
transmission  would  vary  significantly  across  the  image. 

Note:  The  shift  in  wavelength  of  peak  uansinis.sion  for  parallel  light  incident  or.  a  niter  at  angle  6 
(radians)  is  given  by. 

_  -  9  ^  where  p*  is  the  effective 

\  2(1*  2  refractive  index. 

Similarly,  ihe  shift  in  peak  transmission  for  a  cone  of  light  of  scmi-angic  a  (radians)  incident  on  a 
filter  with  the  cone  axis  at  normal  incidence  is  given  by: 

A2^  =  •  L  a} 

X  2  2m*2 
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1.3  Commercial  Lens  Types: 


There  are  a  number  of  commercial  "medium*format"  camera  lens  ranges  that  give 
appropriate  image  sizes  for  the  HAARP  optics.  Table  1  below  compares  these  possibilities; 
here  Efficiency  is  a  measure  of  the  total  light  collected  by  the  lens  into  the  image  format  of  the 
lens  (or  throughput)  ,  so  is  proponional  to  Image  Area  divided  by  F  number  (or  d^/F#). 
Consideration  of  the  various  options  leads  to  the  selection  of  the  Pentax  6x7  series  as  being 
overall  most  suitable  for  this  application. 


1.4  Telecentric  Optics: 

The  exit  ray  cones  from  a  commercial  fisheye  lens  arc  made  telecentric  by  the  addition 
of  lenses  near  the  image  plane.  Figure  1.2  shows  the  right-hand  part  of  the  ray  diagram  of 
Figure  1.1,  with  the  addition  of  two  plano-convex  elements  (B  in  Figure  1.2)  to  produce  a 
telecentric  configuration. 


Notes:  1.  A  single  bi  convex  lens  would  result  in  considerable  spherical  abeirauor, 

2.  A  single  plano-convex  lens  would  have  a  very  small  radius  of  curvature  to  achieve  the  required 
(small)  focal  length,  and  would  have  considerable  spherical  aberration  (but  less  than  Case  I) 

3.  Two  piano  convex  lenses  allows  reasonable  surface  curvature,  and  further  reduce  spherical 
aberration  compared  to  Case  2. 

4.  Three  plano-convex  lenses  would  lead  to  a  further  small  improvement  in  sphcncal  aberration, 
but  is  not  justified  in  terms  of  reduced  vansmission  and  expense. 

5.  The  oricniauon  of  the  two  plano-convex  lenses  is  chosen  to  share  refraction  approximately 
equally  between  the  four  surfaces,  leading  to  less  aberrations  than  any  other  iwo-elcment 
configiirauon. 
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Mudlum  Format  Lens  Comparisons  tor  HAARP  Imager 
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The  effective  focal  length  of  the  two  plano-convex  elements  is  chosen  to  equal  the  distance 
from  the  exit  pupil  [A  in  Figures  1.1, 1.2]  of  the  lens  to  the  principal  plane  of  the  two-lens 
combination  [B  in  Figure  1.2] .  Thus  the  principal  rays  of  all  image-forming  cones  ate 
refracted  parallel  to  the  principal  axis  of  the  lens. 

This  is  the  so-called  telecentric  configuration.  This  allows  the  use  of  narrow-band 
interference  filters,  with  a  maximum  ray  angle  through  the  filter  determined  by  the  F  number  of 
the  lens  (e.g.,  7.1°  for  F4.0).  Note  that  the  image  size  is  slightly  smaller  than  that  formed  by 
the  primary  lens  itself. 


1.5  Variable  Field  of  View: 

Different  primary  lenses  are  used  to  achieve  a  range  of  fields  of  view,  but  in  each  case 
appropriate  telecentic  elements  and  spacings  must  be  selected  (see  Figure  1.3).  For  the 
HAARP  instrument,  all  primary  lenses  are  in  the  same  commercial  series  (Pentax  6x7  format), 
and  these  are  mounted  onto  telecentric  lens  housings  with  the  appropriate  plano-convex 
elements  and  spacings.  These  combined  primary  lens/telecentric  lens  assemblies  are  then 
interchangeable,  in  that  they  all  give  the  same  image  size  and  same  telecentric  cone  angle,  so 
that  the  following  optics  is  the  same  for  all. 


1.6  -Accuracy  of  Telecentricity: 

The  telecentricity  achieved  is  not  perfect,  but  varies  across  the  image.  Figure  1.4 
shows  the  deviation  from  perfect  telecentricity  for  the  fisheyc  lens  of  Figure  1.1,  with  various 
combinations  of  two  plano-convex  telex:entric  elements.  The  z;ro  crossover  point  can  be  set 
anywhere,  and  is  normally  chosen  to  be  at  about  0.75x  die  image  radius  so  as  to  minimize  the  ± 
deviations.  (To  achieve  better  telecentricity  than  the  ±  1°  sliown  would  require  specially 
designed  aspheric  elements.) 
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FoV  =  19° 


Figure  1.3;  Shows  typical  ray  diagrams  for  some  other  lenses  with  smaller  fields  of  view. 
Telecentric  elements  may  be  chosen  for  each  of  these  lenses  (but  focal  lengths  and  spacings 
differ  for  each  primary  lens). 


Deviation  (Degrees) 


Deviation  of  Exit  Cone  from  Perfect  Teiecentricity 

(Fisheye  Lens) 


Fietd  Angle  (Degrees) 

Figure  1.4:  Shows  deviation  from  perfect  teiecentricity  for  various  focal  lengths  of  the 
combined  plano-convex  telecentric  elements.  Appropriate  choice  of  focal  lengths  (-  87.5 
mm)  and  spacings  limits  deviation  to  ^  ±1  degree. 

1.7  Ke-imaging  Optics: 

The  re-imaging  optics  to  the  image  intensifier  is  shown  schematically  in  Figure  1.5. 


Figure  1.5;  Re-imaging  optics  schematic 


The  rays  making  up  individual  image-forming  cones  would  continue  to  diverge  after 
the  primary  focal  plane  (C  in  Figure  1.5),  and  portions  of  each  ray  cone  would  be  lost  from  the 
following  optics.  Consequently  a  field  lens  (D  in  Figure  1..5]  is  inserted  just  after  the  filter 
position.  To  minimize  aberrations,  an  achromatic  doublet  is  used  in  the  orientation  shown. 
The  focal  length  of  this  lens  depends  on  the  final  image  size  desired.  The  camera  lens  (F  in 
Figure  U]  is  placed  near  the  common  pupil  of  all  the  ray  cones  from  the  image.  To  minimize 
aberrations  (especially  field  curvature),  it  is  desirable  to  use  the  camera  lens  at  near  its  infinity 
focus.  Consequently  a  close-up  lens  (E  in  Figure  1.5]  is  placed  in  front  of  the  camera  lens, 
with  its  focal  length  chosen  to  be  the  same  or  slightly  longer  than  that  of  the  field  lens.  Again, 
to  minimize  aberrations,  an  achromatic  doublet  is  used  with  the  orientation  shown.  The  field 
lens  and  close-up  lens  configuration  is  shown  in  Figure  1.6 


Figure  1.6:  Field  lens  and  close-up  lens 

The  focal  length  (0  of  the  camera  lens  |F  in  Figure  1.5)  and  its  separation  (L)  from  the 
primary  image  plane  is  determined  by  the  required  final  image  size  (d)  on  the  detector.  If  D  is 
the  primary  image  diameter,  then: 


d/D  =  f/L 

D  is  fixed  by  the  choice  of  primary  lens  format  (nominally  92  mm  for  the  Pentax  6x7  medium- 
format  lenses  (but  this  diameter  is  reduced  slightly  because  of  the  telecentric  elements,  see 
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Figure  12).  Specification  of  d  defines  f/L.  f  can  then  be  chosen  according  to  various  other 
requirements,  such  as: 

(i)  Values  of  f  available  in  commercial  camera  lenses. 

(ii)  To  minimize  optics  size,  choose  a  small  f. 

(iii)  To  minimize  field  curvature,  choose  a  larger  f. 

(iv)  To  maximize  sensidvity,  choose  f  so  lowest  F  number  lens  can  be  used. 

(v)  f  must  also  be  chosen  so  that  the  whole  final  image  diameter  can  be  covered  at  the 
chosen  F  number. 

(vi)  f  should  not  be  so  small  that  L  is  too  small  for  the  procurement  of  a 
pracdcal  close-up  achromat  with  the  required  diameter. 

Note:  Typical  example: 

1.  d  -  24  mm  (to  fit  an  25  mm  image  intensifier). 

Then  using  a  Pentax  primary'  lens, 

AID  =  24/89  ~  0.27  (tclecentric  plano-convex  lenses  reduce  the 

normal  92  mm  image  diameter  to  89  mm) 

If  f  =  50  mm,  then  L~  185  mm,  and 

if  f  =  85  mm,  then  L~  315  mm 

If  F  is  the  F  number  of  the  primary  lens,  and  all  of  the  light  is  re-imaged  to  a 
final  image  size  d,  then  the  required  F  number  of  the  camera  lens  (so  as  to  collect  all 
available  light)  is 


FCam  ^  F  X  d/D 

In  the  above  case  with  F  =  4.5  and  d/D  =  0.27,  a  FI. 2  camera  lens  would 
be  required.  In  general  if  space  allows,  it  is  best  to  choose  the  longer  focal  length 
camera  lens  so  as  to  minimize  image  curvature  (see  following). 
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1.8  Field  Curvature: 


There  will  always  be  some  residual  field  curvature.  This  is  reduced  if  longer  focal 
length  camera  lenses  are  chosen,  but  this  is  not  always  possible  or  desirable.  The  curvature  can 
be  significantly  reduced  if  a  field  curvature  correction  lens  (a  plano-concave  element,  G  in 
Figure  1.5)  is  placed  just  in  front  ( 1  -2  mm)  of  the  final  image  plane.  For  maximum  resolution, 
this  field  curvature  corrector  is  desirable  if  allowed  by  physical  restraints  at  the  detector.  The 
focal  length  of  the  field  curvature  correcting  lens  for  minimum  field  curvature  was  determined 
by  trial  and  error,  and  for  the  HA  ARP  optics  is  f  =  -100  mm.  A  comparison  of  ray  diagrams 
with  and  without  the  field  curvature  correction  lens  is  shown  in  Figure  1.7 
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1.9  Image  Intensifier: 


The  image  intensifier  used  is  a  25  mm  Gen  II  Inverter  tube  (Figure  1.8)  This  type  of 
intensifier  is  superior  to  proximity-focused  tubes  for  gain  and  resolution,  and  is  also 
considerably  less  expensive.  If  near  infra-red  images  were  desirable,  then  a  hybrid  tube 
consisting  of  an  Gen  111  (GaAs)  proximity  tube  coupled  to  a  single-stage  inverter  tube  is  also 
available  and  interchangeable  with  the  present  tube. 

The  cathode  is  a  thinned  tri-alkali  (for  improved  blue  quantum  efficiency)  and  the 
output  phosphor  is  a  P20  (for  good  time  response,  with  a  decay  time  to  the  10%  level  of  ~  1-2 
msec). 


The  intensifier  is  housed  in  a  custom-designed  thermoelectric  cooler,  that  cools  just  the 
cathode  (to  reduce  dark  noise)  but  leaves  the  phosphor  at  ambient  (so  as  not  to  increase 
phosphor  decay  time).  Cooling  is  to  about  20OC  below  ambient,  which  gives  a  10:1  reduction 
in  thermal  dark  current. 


The  electrostatic  image-inverting  generati,  i  2  image  tube 


Figure  1 .8:  Schematic  of  a  Gen  li  Inverter  tube 
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1.10  Relay  Optics: 


The  output  image  from  the  image  intensifier  has  to  be  coupled  to  the  CCD,  with  a 
reduction  in  size  from  24  mm  to  lO  mm  (CCD  size  is  10.2  x  10.2  mm).  This  coupling  could 
have  been  achieved  with  either  a  fiber  optics  taper  or  with  relay  lenses,  and  there  are 
advantages  and  disadvantages  to  each  approach. 

The  relative  efficiencies  of  fiber  optics  and  relay  lens  depends  on  the  image 
magnification  (  m,  <  1  )  required; 

(a)  For  a  fiber  optics  taper  with  magnification  m,  tfic  coupling  efficiency  is  given  by 

T  X  where  T  is  the  fiber  optics  transmission 

(b)  For  a  non-vignetting  relay  lens,  the  coupling  efficiency  is  given  by: 

T  /  [  m2  +  4xF2  X  (1+  m)2  ]  where  T  is  the  lens  transiiussion 
and  F  is  the  F  number  of  the  relay  lens  (sys'em)  onto  the  detector.  Usually 
m2  ;<  [4xF2  X  (1-t-  m)2]  and  may  be  neglected,  giving  T  /  [  4xF2  x  (1+  m)2  ] 

In  both  cases,  T  -  0.8,  and  the  following  Table  compares  coupling  efficiencies: 


Coupling  Efficiency  of  Fiber  Optics  Tapers  and  Relay  Lenses 


m 

Fiber  Optics 

Relay  Lens 

F  =  C.7 

F  =  1.0  F  = 

1.4 

1 

0.800 

0.090 

0.047 

0.025 

0.5 

0.200 

0.172 

0.086 

0.045 

0J3 

0.087 

0.224 

O.Ill 

0057 

0.25 

0.050 

0.256 

0.127 

0.065 
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It  may  be  seen  that  although  fiber  optics  is  much  more  efficient  for  1:1  coupling,  its 
advantage  quickly  decreases  as  magnification  decreases  (as  is  common  when  coupling  from 
image  intensifiers  to  CCDs),  and  for  m  S0.33,  relay  lenses  may  be  as  efficient  or  even  more 
efficient. 

There  are  many  other  factors  that  enter  into  the  choice  between  fiber  optics  and  relay 

lenses: 

(i)  If  the  detector  is  to  be  cooled,  it  may  not  be  desirable  to  use  fiber  optics  coupling,  as  the 
added  thermal  load  will  make  CCD  cooling  difficult.  The  best  solution  in  this  case  may  be  to 
cool  the  complete  CCD  camcra/fiber  optics/intensifier  combination. 

(ii)  If  commercial  CCD  cameras  are  to  be  used,  it  may  not  be  possible  to  use  fiber  optics 
coupling,  as  most  to  not  come  with  the  option  of  a  fiber  optics  faceplate  on  the  CCD.  Specialty 
scientific  cameras  with  fiber-optics  faceplate  CCDs  are  much  more  expensive  than 
commercially  available  cameras. 

(iii)  Fiber  optics  may  be  necessary  if  iheic  are  physical  size  and/or  weight  lestrictions,  as 
relay  lenses  are  considerably  larger  and  heavier.  Similarly,  fiber  optics  will  be  advantageous  if 
there  arc  .‘hock  or  vibration  conditions. 

(iv)  Fiber  optics  will  generally  reduce  resolution  more  than  relay  lens  systems. 

The  following  considers  aspects  of  relay  lens  coupling: 

For  high  efficiency  and  high  resolution  image  transfer,  simple  lenses  or  even  achromats 
arc  unsuitable,  as  they  v.  ill  .suffer  from  large  field  curvature  (as  well  as  other  aberraiicns).  A 
compound  lens  (such  as  camera  or  enlarging  lens)  that  is  designed  for  close  conjugate 
applications  can  be  used,  but  generally  the  effective  F  number  will  be  high  so  the  coupling  will 
be  inefficient. 

Typically  two  lenses  are  used: 

(i)  a  collimator  Icn.s  io  collect  light  from  the  image  intensifier  output  screen; 

(ii)  a  camera  lens  to  image  the  light  onto  the  CCD  detector. 

This  arrangement  allows  boih  lenses  to  be  used  at  their  infinity  conjugate,  and  so  maxim.izcs 
coupling  efficiency  and  minimizws  aberrations. 
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Normal  camera  lenses  (e.g.  Nikon,  Canon)  cannot  be  used  in  tandem  configuration  as 
serious  vignetting  results.  A  specially  designed  collimator  lens  (that  "overfills"  the  camera 
lens)  is  required,  such  as  those  available  from  Rodcnstock.  Normal  camera  lenses  can  then  be 
used  as  the  final  imaging  lens,  though  Rodenstock  also  supplies  high-speed  camera  lenses 
especially  designed  for  use  in  tandem  configuration  with  their  collimator  lenses.  (See  Figure 
1.9). 


The  ratio  of  focal  lengths  of  the  camera  and  collimator  lenses  determines  the  image 
magnification,  as  follows: 

m  =  Focal  lenah  of  camera  lens 
Focal  length  of  collimator  lens 
~  0.4  for  the  HAARP  configuration. 

The  fastest  available  relay  lens  pair  is  a  Rodenstock  lOOmm/FI.5  coupled  to  a  Rodcnstock 
42  mm/FO.75. 

If  Pcam  is  the  F  number  of  the  camera  lens,  and  Fcoli  is  Uic  F  number  of  tlie 
collimator  lens,  then  for  the  relay  lens  system  to  have  no  vignetting,  the  requirement  is  that 

Fcam  /f^coll  £  "i 

For  the  HAARP  configuration,  m  =  0.42  and  Fcoli  =  FI. 5,  so  we  require  FcamS 
0.63  The  camera  lens  used  (42  mm/FO.75)  almost  meets  this  requirement,  accepting  a  FI. 8 
cone  from  the  collimator  lens  (thus  using  70%  of  the  light  collected  by  the  collimator  lens). 
Fast  camera  lenses  like  this  have  very  short  back  focal  distances  (-  few  mm),  so  it  was 
necessary  to  specially  design  the  lens  mount  configuration  for  the  Photometries  CCD  camera. 

1,11  Anti-Fogging: 

There  is  always  the  possibility  with  cooled  detectors  that  some  surfaces  may  fog  or  ice 
up  in  humid  environments.  Consequently  the  capability  of  dry  N2  flushing  has  been  built  into 
the  HAARP  instrument.  Both  sides  of  the  cover  glasses  in  front  of  the  image  iniensifier,  and 

the  front  of  the  CCD  cover  glass  (the  back  side  is  in  an  evacuated  environment)  can  be  flushed. 

Experiments  have  shown  that  flushing  for  ~  1  minute  will  rapidly  remove  any  condensation. 
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Vignetting  in  a  tandem  system 
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i.i2  Shutters: 


There  are  two  shutters  in  the  instrument,  one  in  front  of  the  intensifier  lens,  and  the 
other  between  the  two  relay  lenses.  This  allows  independent  determination  of  intensifier  and 
CCD  noise  characteristics.  In  addition,  there  is  a  light  sensor  built  into  the  input  side  of  the 
relay  lens  shutter.  This  allows  pre-monitoring  of  the  output  of  the  image  intensifier,  this 
information  can  be  used  to  adjust  exposure  time  or  high  voltage  setting  of  the  intensifier,  so  as 
to  keep  the  image  well  placed  within  the  dynamic  range  of  the  CCD  detector,  and  to  determine 
if  the  image  intensifier  is  near  its  AGC  (automatic  gain  control)  mode. 

1.13  High  Light  Protection  Light  Sensor: 

A  sensor  is  built  into  the  front  of  the  filter  wheel  to  measure  the  ambient  light  level.  If 
this  higher  than  a  preset  limit,  the  image  intensifier  will  not  be  allowed  to  turn  cn. 
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2.1  Advanced  Technologies  CCD  Head 


2.1.1  Advanced  Technologies  Delivered  S(>ecifications 

Figure  2.2  contains  die  original  performance  specifications  as  set  by  Advanced 
Technologies  6^74/92.  There  were  six  images  supplied  with  the  camera  that  are  useful  for 
reference  (Figure  2.3): 

Low-level  resoludon  image  Hi-level  resoludon  image  Dark  Noise  image 
Lo-Gain  Bias  Mid-Gain  Bias  Hi-Gain  Bias 

It  was  nodeed  that  the  Bias  setdngs  were  unnecessarily  high  and  were  limiting  the  dynamic 
range  of  the  instrument  (  100/4096  =  2.5%  ).  In  the  dark-noise  integradon,  one  can  nodee 
the  intrinsic  pattern  of  dark-noise  buildup  for  these  CCDs. 

Upon  taking  images  with  the  HAARP  Imager  and  comparing  them  to  the  MIP  and  ASIPIl 
imagers,  it  was  nodeed  that  die  HAARP  CCD  images  were  flipped  and  rotated  90  degrees 
CW  as  Figure  2.1  shows: 


around  horizontal  axis  around  horizontal  axis 

and  rotated  90"  CW 

Figure  2.1:  CCD  Orientations  9/23/92 
2.1.2  Advanced  Technologies  RMA  11/17/92: 

The  HAARP  CCD  Hcad/Electronics  was  relumed  to  Advanced  Technologies  to  fix  the 
abc»vc  problems.  Tlie  CCD  was  rotated  90  degrees  inside  the  vacuum  chamber  and  the 
biases  were  lowered  to  increase  the  dynamic  range  of  the  ADC.  Figure  2.4  contains  the 
calibration  images  from  this  RMA. 
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CAMERA  PERFORMANCE  TESTS 


Open-Loop  Tempemture:  *C  Regulated  Temperature: _ ’C 

Dark  Current  _ NON-MPP  Idode  : _  e-/  at  *C  at _ gain  (actor 

Bias  Mean  DiveJ;  I'io  ADU  atx^  gain  factor 

Well  Capadt,  at  A/D  Converter  Limit;  2oO  ke-  at  k  a.  gain  factor 

Reduced  Full  WeD  Capacity  In  MPP  Modern- ?e>o  ke-  at  iV  gain  (actor 


GADV/NOISE  MEASUREMENTS 

IC  S«  rtem 

A/D  Conversion  Rsctor 

Measured  at  IX  Gain:  fiS*  e-/ADU 

Noise: 

€• 

o-^enfied  at  2X  Gain  79.5“ 

Noise: 

_e- 

«--Venfled  at  4X  Cam  2  </,  */ 

Noise: 

-  c- 

FINAL  VACUIDI  TESTS 

Final  Pump  and  Bake  Cycle  Performed  t  /^  Hours) 


Final  Water  Vapor  Test  Performed 
____  Final  Helium  Leak  Test  Performed 

- Vacuum  Valve  Packed  With  Crease 

— .  -  Final  Vacuum  Leak  Check  Performed 

FINAL  VOLT/UIE  SETTINCS 

Vod _  ♦Vjh _  -Vsh _ 

Vrd _  ♦Vvp _  -Vvp _ 

Vog _  -KIR _  -OR _ 


Comments 


Testing  performed  by 
Approved  by _ 


Date  ^  V  - 
Date 


Figure  2.2a  --  Advanced  Technologies  CCD  Specifications  6/24/92 

Performance  Tests 
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ATC-5  TEST  REPORT 


CUSTOMER  _ Q _ 

ATD  JOB  NUMBER  A  t  7 _ 

CAMERA  HEAD  SERIAL  NUMBER  J2. _ 

ELECTRONICS  UNIT  SERIAL  NUMBER. _ 

COOLING  UNIT  SERIAL  NUMBER  sJ  _ 

FINAL  ASSEMBLY  AND  TEST  BY  Q  - 

date  _ _ 

CCD  TYPE  _ 

CCD  SERIAL  NUMBER _ _ 


CCD  PARAMETERS 


VOD1 

- 

VOD2 

■24.0 

VRD 

12 . 5- 

VOG 

VSL 

VSH 

VPL 

-■7.  S3  _ 

VPH 

•^3.  esr 

VSWl 

VSWH 

4  5"'  34 

VTGL 

VTGH 

3.7  / 

VRH 

'7.  cb 

VRL 

— .  0^ 

VIG 

hj  P> 

VID 

VSUB 

_ _ 

^COA  t> 

_ _ 

3.01  K 

Figure  2.2.b  -  Advanced  Technologies  CCD  Specifications  6/24/92 

Voltage  Settings 
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1  icurc  2  I  -■  Advii:icc(i  'IcchnolDj^iics  KMA  Iinaj:cs  1  1/17/92 


2.1.3  CCDFlatfield 


Figure  2.5  shows  a  1 -second  exposure  taken  with  this  setup.  The  first  image  is  the  flat- 
field  looking  at  the  full  dynamic  range  of  the  CCD.  The  second  image  expands  the  detail 
to  look  at  the  CCD  variations  in  more  detail. 


[Full  Dynamic  Range;  Black  =  0.  White  =  4095)  (Stretch:  Black  :•  1600,  White  --  1650) 

Figure  2.5  --  CCD  Flat-Field  Images 


There  arc  dust  shadows  on  this  image  that  result  from  very  small  particles  of  dust  on  the 
vacuum  wuidow,  Tiicse  siiadows  do  not  appear  on  the  resultant  image  with  a  lens  as  the 
window  is  not  in  an  i’^rwgc  plane.  Figure  2.6  shows  a  plot  through  the  i.iTiagc  of  column 
261: 
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Fi^u’^e  2.6  --  Column  Plot  from  Flat-Field  Image 

From  the  plot  in  Figure  2.6  and  the  expanded  flat-field  image,  we  can  see  that  there  are 
certain  patterns  that  axe  intrinsic  to  the  CCD  that  appear  when  looking  at  the  flat  field  m 
great  detail.  Notice  the  periodic  horizontal  line  pattern  that  can  be  seen. 

2.1.4  CCD  Resolution; 

A  resolution  chart  was  projected  onto  the  CCD  using  the  42mm  Rodenstock  relay  lens 
(and  the  back  shutter  of  the  instrument  for  exposure  control.  The  iris  of  the  back  shutter 
was  closed  to  about  1/4  aperture.  Since  the  Rodenstock  has  a  maximum  image  size  of 
1 1mm  which  is  smaller  than  the  14.4mm  diagonal  of  the  CCD,  and  in  this  case  the  lens  is 
completely  filled,  you  can  notice  the  blurring  of  the  lens  at  it’s  edges  in  the  resolution 
image  in  Figure  2.7.  Tliis  does  not  affect  our  images  as  the  intensifier  image  does  not 
completely  fill  the  42mrn  lens  image  circle. 

The  theoretical  limit  of  the  CCD  resolution  is  determined  by  the  number  of  pixels  in  the 
image.  The  PM.^16A  uses  512  pixels  across  it's  image  area,  each  with  a  dimension  of 
20x20pm  giving  a  10.2mm  CCD  size.  Thus,  the  maximum  resolution  for  a  line-pair 
(black/white)  for  this  CCD  is  256  line-pairs  or  25  Ip/mm. 
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Figure  2.7  --  CCD  Resolution  Image 


2.1.5  CCD  Bias  Settings 

The  Bias  voltage  is  a  zero-offset'  voltage  that  is  applied  to  the  summation-amplifier  on  the 
CCD  before  it  is  converted  at  the  Analog  to  Digital  Converter  (ADC)  and  assures  that  ue 
are  operating  above  the  threshold  of  the  electronics.  The  bias  is  somewhat  arbitrarily  set 
by  Advanced  Technologies  along  with  the  other  clocking  voltages  (documented  in 
Sections  2.1.1  and  2.1.2)  and  should  not  be  changed  in  the  field. 

Initial  Bias  Settings  (6/24/92)  were:  1.0:105  MID:  103  HIGH,  114 

These  were  lowered  as  discussed  in  Section  2.1.2  to  improve  the  dynamic  range  of  the 
instrument: 

RMA  Bias  Settings  (11/7/92):  LG:  42  MID:  42  HIGH:  61 

Biases  were  clo.sely  watched  dunng  the  calibration  of  the  instrument  as  there  seems  to  be 
some  fluctuation  in  their  values.  Bias  images  were  archived  during  the  Mcan-Vanance 
calibration  (Section  2.1,7)  and  wore  found  lo  be: 

MV  Bias  Readings  (7/1. V93):  1.0:13  MID:  1 1  HIGH:  23 
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Figure  2.8  --  Mid  Bias  image  from  7/13/93  (Tccd  =  -29. 5C) 
(stretched:  black  =  10,  white  =  15) 


Figure  2.8  shows  an  expanded  image  of  the  bias  at  Mid  Gain.  As  in  the  flat-field  image, 
we  again  see  horizontal  patterns  that  are  intrinsic  to  the  CCD  readout, 

A  column  plot  from  a  HI  CCD  gain  Bias  image  in  Figure  2.9  also  shows  the  horizontal 
patterns  intrinsic  to  the  CCD. 


COL  Plot: 


(281,0)  Pixel:  (284„S12) 


Figure  2.9  --  Column  plot  from  HI  Bias  image  (8/27/93) 
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Bias  Readings  (8/27/93); 


LO:  15.74  MID:  13.2  HI:  24.48 


On  9/1/93,  we  looked  at  the  BIAS  levels  verses  time.  The  following  results  were  found: 
Powered  Down/Up  tl.e  Camera  and  take  BIAS  readmes  repetitively 


Temp 

-28.5C 

-29.5C 

-29.5C 

-29.5C 


LOBias 
1.1  +/-  .8 
2.78  +/-  .8 
3.61  +/-  .9 
5.45  +/-  .8 


MID  Bias 
0.19+/-. 5 
1.03  +/-  1.0 
1.73+/-  1.1 
3.26+/-  1.2 


HI  Bias 
8.23  +/-  1.6 
9.77+/-  1.6 
10.8  +/-  1.6 
12.6+/-  1.6 


Powered  Down/Up  and  found  MID  Bias:  5.42  +/-  1.2 


Let  Camera  sit  for  20  minutes  and  take  BIAS  readings  repetitivelv 


CCD  Temp 
-26.5C 
-26.5C 
-26.0C 


LO  Bias 
10.4  +/-  .8 
10.6  +/-  .8 
10.9  +/•  .8 


MID  Bias 
8.2+/-  1.2 
8.4  +/-  1.2 
8.4+/-  1.2 


HI  Bias 
18.5+/-  1.6 
18.7  +/-  1.6 
19.0+/-  1.6 


These  results  show  quite  a  bit  of  drifting  in  the  BIAS  levels  until  they  seem  to  settle  down 
to  a  final  value  with  time.  This  is  probably  due  to  the  temperature  inside  the  CCD 
Electronics  head  where  these  voltages  are  set.  The  fact  that  the  BIAS  level  is  slightly 
different  for  each  session  points  to  three  things: 

(i)  BIAS  levels  should  be  watched  closely  and  recorded  intermittently  during  data 
acquisition  sessions. 

(ii)  If  possible,  the  instrument  should  be  given  time  to  stabilize  (-20  minutes) 
before  data  acquisition  starts. 

(iii)  The  overall  trend  of  BIAS  levels  migrating  down  from  ~40  (11/92)  to  ~13 
(8/93)  is  cause  for  some  concern  and  should  be  watched  closely.  U  the  BIAS  levels  keep 
decreasing  from  these  levels  (approaching  0),  the  camera  should  be  returned  to  Advanced 
Technologies  for  a  new  calibration. 
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2.1.6  COJ  Dark  Noise 


The  PM516A  CCD  is  powered  in  Multi  Pin  Phased  (MPP)  mode  which  decreases  the 
dark  count  by  about  a  factor  of  30.  This  is  achieved  by  using  a  boron  implant  in  the  CCD 
wells.  Figure  2.10  shows  a  dark  integration  image  with  a  CCD  temperature  of  -25°C 
••  hich  is  a  normal  operating  temperature  of  the  KAARJ’  imager.  Notice  the  characterictic 
pattern  of  daric  noise  integration  intrinsic  to  the  CCD  cnip. 


CCD  Temp:  -25.0C  Exposure:  4  minutes  HI  Gain  [25e-/ADU]  1x1  Binning 
Scale:  Black  80  ADU  While  225  .ADU 

Figure  2.10  --  Dark  Noise  Integration 

Temperature  Dependence 

Dark  Noise  for  the  HA  ARP  camera  head  was  measured  verses  temperature.  Cooling  the 
CCD  reduces  the  dark  count  by  about  a  factor  of  10  for  every'  20C  temperature  reduction. 
The  following  data  for  CCD  dark  noise  acquisition  was  taken  with  the  CCD  gain  set  at  HI 
and  using  1x1  binning: 


El9Ctrons/sec 


Temp 

(C) 

Exposure 

(sec) 

Mean 

(ADU) 

RMS 

(ADLO 

Mean 

-  Bias 

Normalized 

Mean 

Elec  irons 

/sec 

31 

20 

1953 

269 

1930 

23160 

2412.50 

-4 

120 

473 

69 

450 

900 

93.75 

-12 

120 

257 

37 

234 

468 

48.75 

-19 

240 

250 

36 

227 

227 

23.65 

-25 

240 

147 

21 

124 

124 

12.92 

'Fhis  curve  is  shown  in  Figure  2.10.  Examing  the  above  results  confirms  the  rule  of  thumb 
for  cooling  viz;  a  factor  of  2  decrease  for  every  6°C,  or  a  factor  of  10  decrea.>e  for  every 
20°C. 

iOOOO  -Y^.  -.^=^====z===.-=========-^^^ - - = 


1000 


j... 


30  -20  -lO  0  10  20  30  40 

Temperature  (C) 

Figure  2. 1 1  --  CCD  Dark  Count  .vs.  Temperature 
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2.1.7  HAARP  Mean-Variance  Calibration 

The  electron  charge  in  the  CCD  wells  creates  a  voltage  that  is  amplified  by  the  CCD 
electronics  and  convened  into  digital  units  using  a  12  bit  Ant  '•g  to  Digital  Convener 
(ADC)  at  a  pixel  rate  of  1.1  MHz.  Hie  Mean- Variance  calibra  on  is  a  method  used  to 
determine  the  actual  Analog  to  Digital  Convener  gain  and  noise  characteristics.  This 
indicates  how  many  electrons  in  the  CCD  well  correspond  to  an  Analog  to  Digital  Unit  or 
ADU.  The  basic  principle  of  this  calibration  is  as  follows; 

Linear  ADC  conversion:  ADU  =  Gain  x  Ng  where  Ng  =  number  of  electrons 
RMS  noise  of  conversion;  o  =  Gain  x  VNg 

Variance  is  defined  as  RMS^.  Therefore,  the  ratio: 

Yanaggg  =  (Gainl^-aJiie 

Mean  Gain  x  Ng 

The  ratio  of  Variance  /  Mean  gives  the  gain  in  units  of  ADU/electrons.  The  ratio  of 
Mean  /  Variance  therefore  gives  us; 

electrons/ADU 

Advanced  Technoloyies.Calibration  Method. 

Four  images  are  collected  with  the  CCD  camera:  two  independent  Bias  images  and  two 
independent  Flat-field  images.  To  do  this,  the  KEO  lab  was  set  up  as: 


Light  '■ 
Source 


I 

I  Aperture 
Shutter 


1 3  feet 


Opal 

Glass 


Rodenstock 
42mm  Lens 


CCD 

PM516A 


.30 


The  following  definitions  were  made; 


Images  taken:  Biasl,  Bias2,  Imgl,  Img2 


MEAN: 

2IMG_RMS: 

VARIANCE: 

GAIN: 

2BIAS_RMS: 
READ  NOISE: 


Mean  of  ( Imgl  •  Biasl ) 
Rms  of  ( Img2  •  Imgl ) 
2IMG,RMS2/2 
MEAN/VARUNCE 
Rms  of  ( Bias2  •  Biasl } 
(2BUS_RMS/sqn(2))X 


[Photon  Shot-Noise  of  images] 
[Variance  of  one  image] 

[units:  electrons/ADU] 


GAIN 


Results  of  7/12/93  Cali 


ij  r-iut]i 


for-HAARP  CCPOtfiid: 


CCD  Head:  ATC-2  AT220  SN:2  Temperature:  -31.0“C 


Low  Gain: 
Mean:  1432.90 

MidGain: 
Mean:  2627.06 

HiGain: 

Mean:  2140.97 


ImgRMS:  5.6 

ImgRMS:  10.32 

ImgRMS.  13.06 


Variance:  15.68 


Variance:  53.25 


Variance:  85.28 


BiasRMS:  .969 


BiasRMS:  1.108 


BiasRMS:  1.327 


CCD  Gain  Gain  (e-/ADU) _ Read  Noise  fe-l 


Low 

91.38 

62.61 

Mid 

49.33 

38.65 

Hi 

25.10 

23.55 

Bias  Statistics  T  =  .26”C 


ms. 

0.616 

0,788 

0.913 


LfntTHH 

Low 

BiasLow.Img 

13.22 

Mid 

Bias  Mid. Img 

11.02 

Hi 

BiasKigh.il  ig 

22.98 
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In  HI  and  MID  gains,  the  ADC  satxirates  before  the  CCD  well  at  4095.  At  LO  gain,  the 
CCD  saturates  at  2395  (not  including  the  BIAS  level).  This  gives  us  the  full-well  potential 
of  our  CCD: 


2395  X  91  e-  ==>  217,945  e-  PM516A  full  well  depth 

At  MED  gain,  the  ADC  saturates  at  200,165  e-  or  very  nearly  the  full  well  depth  of  the 
CCD.  At  HI  gain,  the  ADC  sanuates  at  101,850  c-  or  about  half  of  the  CCD  well  depth. 

For  1x1  binning,  then,  we  can  characterise  the  use  of  these  gains.  When  we  want  to  match 
the  dynamic  range  of  the  CCD  most  closely  with  the  ADC,  wc  should  operate  at  MID 
gain.  When  we  are  counting  very  few  photons  and  want  the  greatest  sensitivity  of  the 
instrument,  we  should  operate  at  HI  gain,  understanding  that  the  dynamic  range  of  the 
instrument  is  halved.  However,  when  struggling  for  every  photon,  dynamic  range  is  not 
usually  an  issue. 

LO  gain  is  setup  for  use  in  larger  binning  situations.  Wc  typically  collect  data  in  2x2 
binning  to  conserve  on  acquisition  time  and  archival  space.  Die  summation  well  on  the 
PM516A  has  four  times  the  well-depth  of  a  pixel,  so  that  when  wc  bin  4  pixels  together 
(2x2),  the  summation  well  can  handle  the  increased  dynamic  range  (  870Ke-).  LO  gain 
has  a  dynamic  range  (in  2x2  binning)  of  4095  x  91c-  which  is:  370Kc-.  This  is  roughly 
double  the  dynamic  range  of  the  MID  gain,  but  one  should  note  that  for  2x2  binning,  the 
ADC  will  still  saturate  before  the  summation  well  (4  pixels  deep),  so  the  full  dynamic 
range  of  2x2  binning  is  not  realized. 

The.se  gains  were  confirmed  radiometrically  using  a  CT4  Light  source  for  comparison.  A 
sequence  of  images  using  the  486.7nm  filter  and  the  iniensifier  at  a  constant  gain  were 
taken  for  each  of  the  CCD  gains  and  added  together  giving: 


HI  Gain 

Image  stats:  15428  ADU 
CCD  Gain:  25e-/ADU 


.MID.flfliJl _ LO  Gain 

7515  ADU  4089  ADU 

49e-/ADU  91e7ADU 
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MH>/LQ _ UilLQ _ HI/MID-- 

Ratio  of  stats:  1.84  3.77  2.05 

Ratio  of  Gains:  1.86  3.64  1.96 

The  correlation  between  these  two  measurements  is  extrenaely  close  as  is  to  be  expected. 

2.1.8  Centering  die  image  in  the  CCD 

Because  of  mechanical  tolerances  ani  the  difficulty  of  physically  centering  the  CCD  inside 
the  vacuum  chamber  exactly  along  the  optical  axis  of  the  instrument,  it  was  noticed  during 
calibration  that  the  image  was  not  centered  in  the  CCD.  From  the  images  taken  during  the 
first  part  of  the  calibration,  it  was  decided  that  the  image  needed  to  be  moved  about  20 
pixels  to  the  left,  or  about  .015". 

CCD  Housing  Modification:  The  CCD  housing  was  modified  to  allow  the  CCD  head  to 
move  inside  and  two  access  holes  were  drilled  in  the  front  of  the  housing  to  access  the 
mounting  screws  on  the  CCD  head  cover  plate. 

CCD  Head  Modification:  The  cover  plate  holes  were  slotted  to  allow  movement  of  the 
CCD  head  with  respect  to  the  cover  plate  thus  moving  the  orienuiion  of  the  CCD  with 
respect  to  the  optics  axis  (the  Rodcnstock  42mm  lens  screws  into  the  cover  plate). 

To  adjust  the  position  of  the  image  in  the  CCD,  remove  the  CCD  head  from  the  CCD 
housing.  Remove  aU  the  4-40  screws  from  the  CCD  cover  plate  on  the  front  of  the  CCD 
head  except  the  two  horizontal  screws  as  shown  in  Figure  2.12. 

Looking  at  the  front  of  the  CCD  Head 

— Remove  screws 

<] - Leave  two  screws  tightened 


Figure  2. 12  -  CCD  cover  pla’c  screws 
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With  just  these  two  screws  holding  the  cover  plate  to  the  CGD  head,  re-install  the  CCD 
head  into  the  CCD  housing  and  take  an  image.  Using  the  two  access  holes  in  the  front 
panel  of  the  CCD  housing,  slightly  loosen  the  two  screws  and  move  the  CCD  head  in  the 
desired  direction  and  re-tighten  the  screws.  Take  another  image.  Repeat  this  process  until 
the  image  is  centered,  and  tighten  the  two  screws  down  tight.  Remove  the  CCD  head  and 
tighten  in  the  remaining  4  screws  in  the  cover  plate.  Re-install  the  CCD  head  in  the 
intager. 


2.2  Relay  Lens  Optics 

As  discussed  in  Section  1.10,  a  Rodenstock  lOOmm  collimator  lens  is  placed  in  front  of 
the  intensifier  output  image  and  is  coupled  to  a  Rodenstock  42mm  camera  lens  which  tc 
images  onto  the  CCD.  Rodenstock  computed  the  Modulation  Transfer  Function  for  the 
HA  ARP  setup  (Figure  2.13)  using  three  different  spatial  frequencies  (  95  Ip/mm,  48 
Ip/mm,  and  24  Ip/mm ).  The  results  are  shown  in  Figure  2.14. 


D 


CCD 
10  2mm 


Rod«nBock  Vacuvm  W<ntcm 
TV 

42mm  FO  75 


Figure  2.13  --  HA  ARP  relay  lens  configurauon  for  Rodenstock  measurements 


Tliere  is  an  intrinsic  loss  of  light  from  the  phosphor  in  the  lens  coupling  determined  by  tl»c 
.solid  angle  subtended  by  the  collimator  lens.  The  plot  from  Rodenstock  gives  an  angle  of 
8.53  for  the  maximum  from  the  focal  plane  to  the  edge  of  the  image.  Since  light  from  the 
pho.splior  exits  over  a  full  180  degrees,  the  lens  at  FI. 5  only  uses  10%  of  the  photons 
emitted  from  the  intensifier  output.  From  the  Rodenstock  plot,  one  can  see  that  there  is 
also  vignetting  in  the  lens  combination  of  7%  (98-91  ). 
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MODUU^TION-TRANSFER  FUNCTION  FOR 
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TV->faHgon  42nun  F  0 . 75 .  draw .  no .  3801  -  2 1 2 . 22  | 
i  Phosphor  :  P  20 _ Separation  ;  10  nun _ | 


BETA'-  -0.4242 
SCALE 


BLENDENDURCHMESSER  -  55.02 
F-STOP  DIAJ^ETER 


ON  4307  -  9001 
E  -  -0.047 


ORTSFREQUENZ :  95.  48.  24.  1/mra 

SPATIAL  FREQUENCYt  ^  F-NUMBER 

p20p(T)  446. Onm  498. Onm  550. Onm  602.0nni  654. Onm 

(Relative)  BEW  I  *)  3.6  16.8  65.4  95.3  87.6  43.8  25.3  13.6  5.8 

( Output ) 


a  -  BEUOUNGSTHEORCTISCIIER  WERT 
DIFFRACTION  LIMITED  VALUE 


SAGITTAL 

MERIDIONAL 


HF.EL 


24  Ip/nm 


•M8  Ip/inm 


95  Ip/nw 


Y  (Olst.  froncBiter  oC  Int) 

Y 

-3,75 

-6.20 

-8.76 

-10.64 

-12.51 

Y'  -  0  (MITTE) 

Y'  •  0  (AXIS) 

(Dlst.  fron  ooiter  of  <XD) 

1.591 

2.651 

3.710 

4.497 

5.258 

WINKEL  (CRAD) 

ANGLE  (DEGREI:) 

2.58 

4.29 

5.99 

7.26 

8.53 

IIELLIGKEIT  (%) 

LIGHT  INTENSITY  <%) 

98 

CHolJtlvf 

97 

Vignetting) 

96 

96 

91 

VLP.ZniCHWNC  (0/00) 
DISTORTION  ;V.1%) 

0.23 

0.2  V 

-0.20 

-1,04 

-6.16 

Figure  2.14  -  Rudcnsiock  Relay  I.ens  MTF  Calculations 
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2.3  Shutter  Modifications 


The  HAARP  imager  uses  two  Mcllcs-Grioi  shutters.  During  calibration  of  the  imager,  the 
back  shutter  staned  failing  intermittently.  KEO  examined  the  rear  shutter  and  found  what 
we  determined  to  be  a  flaw  in  the  shutter  design.  The  coupling  ring  tends  to  rise  in  the 
upper  right  hand  side  when  the  relay  arm  pulls  the  ring  CCW  (opening).  This  rising  action 
causes  friction  in  the  mechanism  and  creates  a  starting  inertia  that  the  relay  can  not  always 
overcome.  It  was  found  that  applying  a  very  light  amount  of  pressure  to  the  outside  part 
of  the  ring  at  this  point  (see  Figure  2.15)  relieves  the  friction  and  allows  the  shutter  to 
operate  freely.  It  was  noheed  that  there  was  wearing  in  the  ring  and  metal  flakes  where 
the  ring  is  held  down  by  the  washer. 


Figure  2.15  --  KEO  Modification  to  Melles-Griot  Shutter 


To  fix  this,  KEO  fabricated  two  plastic  lips  (one  for  each  shutter)  to  replace  the  metal 
washers.  The  plastic  lip  fastens  down  in  the  same  position  as  one  washer  and  extends  over 
the  coupling  ring  applying  a  btile  pressure  on  the  ring.  This  seems  to  have  solved  the 
shutter  failures.  In  the  future,  teflon  holders  could  be  made  if  the  plastic  lips  become 
unreliable. 
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2.4  PhotoDiode  Calibration 


The  KAARP  iniagcr  has  a  photo-dicxic  placed  in  the  back  shutter  (SH2)  of  the  instrument 
to  measure  the  average  brightness  of  the  intensificr  phosphor.  This  measurement  gives  us 
an  idea  of  how  bnght  the  image  is  and.  more  importaj)tly.  whether  the  image  intensificr  is 
operating  in  AGC  (automatic-gain-control)  nxxJe  and  thus  not  operating  with  linear  gain. 
A  typical  image  intensificr  output  curve  is  shown  in  Figure  2.16. 

The  HA  ARP  imager  uses  a  EG&G  VACTEC  VTB9413B  photodiode.  This  photodiode 
has  an  IR  rejection  filter  on  it  and  has  a  spectral  response  (peak  is  580nm;  range  is  320nm 
-  720nm)  similiar  to  the  output  of  the  intcnsifiCT  P20  phospliour.  A  photodiode  was 
chosen  for  this  application  because  of  it's  relatively  fast  risc/fall  times. 

The  photodiode  output  is  amplified  by  an  AD515  inside  the  shutter  housing  (see  Section 
3.11),  and  then  to  the  KEO  Interface  board  where  it's  gain  can  be  adjusted  using  the 
potentiometer  VR4.  T3iis  potentiometer  is  used  to  set  the  output  voltage  going  into  the 
controller's  ADC  to  peak  near  5V  when  the  intensificr  is  in  AGC  mode.  Thus,  by  reading 
lliis  ADC  value,  the  coriuoiicr  can  monitor  whether  the  inlensifier  is  operating  in  it’s  linear 
range  or  not.  (It  turns  out  that  for  auroral  applications,  a  typical  image  docs  not  push  the 
intensificr  output  anywherc's  near  the  AGC  limit). 

Im«g«  Inttntlllvr  Csin  Cnsraclarltllc* 


Log  (.,>ir>od«  lllummanct  O'-cd) 

Figure  2.16  'I’ypical  Image  Intensificr  Output  Curves 
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'fhe  MIP  imager  used  a  VTB9413  photodiode,  which  has  a  glass  window  instead  of  the  IR 
rejection  window.  This  photodiode  has  a  much  higher  output  than  the  HAARP  imager's 
VTB9413B.  To  accomodate  this  difference,  a  5.1  IKH  resistor  had  to  be  added  in  parallel 
to  the  lOKi^  resistor  R1 1  on  the  KEO  Interface  board  to  increase  the  gain  for  the  AD515 
output  (see  the  schematic  in  the  Hardware  Chapter).  The  output  at  very  low  light-levels 
from  the  AD515  was  found  to  be  greater  than  0  volts  which  produces  a  negative  voltage 
at  the  input  :o  the  ADC  (producing  0  ADU's).  This  limits  the  photodiode's  very  low-light 
level  resolution  as  can  be  seen  in  the  calibration  data.  A  zero-offset  potentiometer  could 
be  added  to  the  ADS  15  amplifier  card  if  necessary. 


The  following  is  the  Photodiode  calibration  data  for  8/27,^93 : 
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ADC  Output  (A' 


1000 


Light  Source  Output  (Normalized  to  Lowest  Setting) 

Figure  2.17c  --  PhotoDiode  Oiitpul  --  ADC  Oupul 


PhotoDiode  Output:  PE4  .vs.  ADU  -  HAARP  8/93 
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Figure  2.17d  --  PhotoDiode  Ouput  —  ADC  Linearity 
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2.5  Image  Intensifier  Performance 


The  HAARP  imager  has  a  25mm  Gen-2  Inverter  intensifier  with  an  S20ER  photocathode 
and  a  P-20  phosphor. 


2.5.1  VARO  Specifications 


SERIAL  NO.  9301115 

25MH  2ND  GEN  INVERTER  WITH  P-20  PHOSPHOR 
PART  «  510-3697-302 

WHITE  LIGHT  PR  e  2854 ‘K:  295  pA/lumen 

PHOTOCATHODE  SENSITIVITY: 


WAVELENGTH 


PHOTOREGPONSE 


(nm) 

(ma/w, 

900 

1 

830 

12 

800 

17 

700 

28 

600 

41 

550 

47 

500 

50 

450 

51 

400 

66 

350 

69 

EBI  (Equivalent  Background  Input)  1.6  X  10-11  ( lUTnens/cm^ ) 


e  5  X  10~®  INPUT  ILLUMINATION: 
INPUT  CURRENT 

e  5  X  10"5  input  ILLUMINATION: 
INPUT  CURRENT 


90,000 

16  nllliaicps 
6,665 

15  millian’ips 


OUTPUT  BRIGHTNESS 

e  5  X  10“*  INPUT  ILLUMINATION: 
INPUT  CURRENT 

9  5  X  10~3  input  ILLUMINATION: 
INPUT  CURRENT 

9  5  X  10~2  input  ILLUMINATION: 
9  10  X  10°  INPUT  ILLUMINATION: 


1.2  F.L. 

14  milliantps 

1.2  F.L. 

14  nilliamps 

1.4  F.L. 

OFF 


CATHODE  AND  SCREEN  QUALITY:  OK 


CENTER  RESOLUTION; 


32  LP/MM 


Figure  2.18  -  VARO  Intensifier  Specifications 
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RELATIVt  RADIANT  LNERGY 


2.5.2  P20  Phosphor  Spectral  Curve 


F'igurc  2.19  --  P20  Phosphor  Spectral  Output 
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2.5.3  Image  Intensificr  Resolution  and  CCD  Resolution 


The  Image  Intensifter  is  quoted  from  VARO  as  having  a  center  resolution  of  32  Ip/mm  at  a 
Modulation  Transfer  Function  of  2.5%  which  is  what  the  eye  can  just  detect.  VARO 
quotes  their  tubes  at  three  different  resolutions: 


2.5  Ip/mm  MTF:  90% 

7.5  Ip/tnm  MTF:  60% 

15  Ip/mm  MTF:  25% 


KEO  projected  a  TV  pattern  directly  onto  the  front  of  the  image  intensificr  and  looked  at 
the  intensifier  resolution  (Figure  2.20).  To  do  this,  the  curvature  correction  lens  and  the 
cooler  window  were  remo'.  ed. 

As  discussed  in  Section  2.1.4,  the  theoretical  limit  of  the  CCD  at  full  resolution  is  25 
Ip/mm.  Because  we  are  mapping  a  10mm  CCD  image  from  a  25mm  Intensificr  image 
(100mm/42mm  gives  a  2.4:1  image  reduction),  this  limit  gets  transformed  back  to  10 
Ip/mm  on  the  image  intensifier.  According  to  the  above  specifications,  we  get  an  MTF  of 
about  40%  at  this  resolution. 

This  points  out  that  the  CCD  is  the  limiting  factor  for  the  imager.  Further,  if  we  acquire 
images  at  2x2  binning  giving  the  CCD  a  pixel  size  of  40um,  the  CCD  resolution  limit  is  12 
Ip/mm  which  corresponds  to  5  Ip/mm  on  the  intensifier  giving  an  MTF  of  about  75%.  The 
resolution  limit  of  the  intensifier  is  quoted  in  the  VARO  specs  at  32  Ip/mm  which  would 
give  80  Ip/mm  resolution  at  the  CCD  (requiring  6um  pixels  corresponding  to  a  1632x1632 
10.2mm2  CCD!). 

The  real  resolution  of  the  imager  is  worse  than  this,  however,  because  these  calculations 
assume  that  the  'pixeLs'  of  the  intensificr  exactly  overlap  the  pixels  of  the  CCD.  In 
practice,  this  never  happens  as  light  from  on-  intensifier  pixel'  falls  into  adjacent  CCD 
pixels  thus  lowering  the  effective  MTF  of  the  image. 
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Figure  2.20  --  System  Resolution  with  Iniensifier 


From  examining  the  resolution  image  in  Figure  2,20,  one  can  by  eye  discern  the  four 
resolution  lutes  down  to  about  200.  Convening  this  to  full  resolution  (accounting  for 
fitting  the  rectangle  in  a  circle,  rather  than  the  circle  in  the  rectangle)  corresponds  to  about 
300  lines,  300  lines  over  the  25  mm  uitensificr  comes  out  to  about  12  Ip/mm  which  is 
close  to  the  theoretical  Limit  of  the  CCD.  One  can  sec  higher  resolution  by  looking  at  the 
intensifier  directly  which  confirms  that  the  CCD  is  the  limiting  factor  for  the  imager's 
resolution. 


2.5.4  Lniage  Intensifier  Mask 

On  the  resolution  image  in  Figure  2.20,  one  notices  a  bright  ring  around  the  edge  of  the 
intensifier.  It  was  found  during  calibration  that  this  ring  is  dependent  on  light  at  the  edges 
photocathode.  In  Figure  2.21,  one  can  see  this  effect  more  dramaucally. 
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Figure  2.21  --  Image  Intensifier  Edge  effects 


KEO  has  noticed  this  problem  ftequently  when  using  VARO  intensifiers.  An  engineer  at 
VARO  confirmed  that  their  tubes  do  have  this  problem  and  that  it  is  related  to  Uie  cleaning 
process  of  the  micro-channel  plates  that  increases  the  sensitivity  at  the  edges  of  the  image. 


Since  the  actual  image  from  the  front  optics  is  imaged  to  be  23mm  in  size  on  the 
photocathode  of  the  intensifier  it  was  decided  by  KEO  to  put  a  mask  on  the  front  of  the 
intensifier  that  would  block  light  from  hitting  the  edges  of  the  photocathode.  The  actual 
image  size  was  first  meastircc  on  the  intensifier  as  shown  in  Figure  2.22 


Measurements  from  Image 


N  -  473 

/  Intens  35  to  436 
Image:  55  to  425 


N  =  454 

Intens:  26  to  418 
Image:  42  to  401 


Front  ot  the  physical 
Image  Intensifier 


Figure  2.22  --  Fishcyr  Image  on  tlic  Intensifier  and  it's  ineasuremcnt 
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As  can  be  seen  in  the  above  figure,  the  orientation  of  the  image  in  the  intensifier  was 
carefully  measured  and  found  to  be  slightly  askew.  The  diameter  of  the  intensifier  in  plot- 
points  along  tlie  above  plots  is  about  400  points  or  16  points/mm.  From  the  above 
measurements,  the  image  is  about  2i  mm  (image  diameter;  370  points)  which  confirms  the 
optics  design.  It  should  be  noted  for  Figure  2.22  and  the  above  numbers,  that  the  term 
'points'  in  this  case  is  a  relative  diagonal  of  the  CCD  pixel  size.  This  comes  about  fiom  the 
way  the  AFG  software  reads  a  line  of  pixels  at  an  angle.  Assuming  the  plots  were  at  about 
45°,  the  CCD  pixel  dimensions  would  be  about  1.4  times  these  values. 

An  Image  Mask  was  fabricated  out  of  Dclrin  with  a  23.5inm  ID  offset  .010"  from  the 
center  of  the  mask  assemby.  This  assembly  was  inserted  into  the  recessed  space  of  the 
curvature  correction  lens  holder,  between  the  lens  and  the  intensifier.  Care  was  taken  to 
assure  that  the  mask  offset  matched  that  of  the  image.  An  image  was  taken  with  no  lens 
on  the  front  (MASKNOLN.IMG)  and  with  the  Fish-Eye  lens  (MASKFSH2.IMG)  to 
check  that  the  mask  was  not  blocking  out  any  of  the  image.  10  pixel  locations  were 
measured  along  the  edge  of  each  of  the  circles  and  then  the  respective  circle  geometries 
were  calculated  in  CCD  pixels  from  these  points: 

Intensifier  Image:  R  =  262puels  X<„g=246  Y,^  =  267 

Intensifier  Mask;  R  =  248  pixels  X<,ij  =  244  Yo,  =  266 

Fisheye  Image;  R  =  243  pixels  Xo,  =  253  Yo,,  =  261 

The  mask  distorts  sUghtly  when  placed  in  the  lens  holder  and  thus  does  not  form  a  perfect 
tarclc  in  the  intensifier  image.  As  seen  in  Figure  2.23,  the  mask  greatly  reduces  the  edge 
affea  of  tlic  image  intensifier. 

This  image  also  points  out  the  image  centering  problem  talked  about  in  Section  2.1.8  and 
fixed  later  during  the  calibration.  In  addition  to  centering  the  image  in  the  CCD,  the  image 
needed  to  be  centered  somewhat  in  the  intensifier  image.  To  do  this,  the  bayonet  mount 
for  the  Canon  85mm  lens  was  tightened  with  pressure  applied  towards  the  top  of  the 
intensifier  housing,  and  a  .005"  shim  \^  as  put  under  the  front  shutter  to  raise  the  Close-up 
lens  slightly.  As  can  be  seen  from  the  above  data,  the  Fisheye  image  is  now  fairly  well 
centered  with  respect  to  the  CCD  (dx  =  -2  pixels,  dy  =  +6  pixels). 
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Using  the  data  above,  the  25mm  intcnsifier  has  a  radius  of  262  pixels,  or  10.5  pixels/mm. 
This  gives  an  image  size  of  243/10.5  =  23.1  mm  which  confirms  the  optics  design.  This 
also  shows  that  the  image  is  offset  from  the  CCD's  optical  axis  by  -0.2mm  (X)  and 
-K).6mm  (Y). 


Figure  2.23  --  Image  Intensificr  with  Mask  (no  front  lens) 
2.5.5  Image  Intensificr  Rat-Field  --  System  Rat-field 


Getting  an  accurate  flat-field  image  of  the  system  has  always  been  a  veiy  challenging  task 
for  the  calibration  of  the  instrument.  Assuming  all  non-uniformities  in  front  of  the  image 
intensificr  have  spherical  symmetry  (vignetting  curves),  a  good  flat-field  of  the  system 
from  the  image  iniensifier  back  will  be  fairly  accurate.  (X  course,  the  non-uniformity  of 
the  filters  are  not  taken  into  account  in  this  analysis.  One  could  isolate  the  non-uniformity 
of  the  intcnsifier  by  taking  into  account  the  1%  vignetting  of  the  re-imaging  optics 
(Section  2.2)  and  using  the  CCD  flat-field  image  (Section  2.1.3). 


VARO  Image  Intcnsifier  tubes  are  not  rated  to  be  very  uniform  as  they  arc  produced  for  a 
mil-spcc  standard  where  uniformity  is  not  a  necessary  requirement.  The  factory 
specification  for  uniformity  is  to  within  2:1.  Visual  inspieciion  of  the  HA  ARP  image 
intcnsifier  revealed  an  unsually  uniform  tube  compared  to  most  of  the  lubes  KEO 
Consultants  has  received  in  the  past. 
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To  get  an  intensificr  flat-field,  the  curvature  correction  lens  had  to  be  removed.  Figure 
2.24  demonstrates  the  calibration  setup  used.  To  cut  down  on  ambient  room  light 
distorting  this  flat-field,  the  calibration  was  done  at  night  with  great  care  taken  to  minimize 
contaminating  light  sources. 


=CD 
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Shutter 
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Figure  2.24  --  Image  Intensifier  flat-field  Setup 


The  intensifier  tube  used  in  the  HAARP  imager  was  delivered  with  a  back  fiber-optics 
plate  mis-alignment  of  greater  than  .005"  (.002”  out  of  specification).  Because  of  this, 
there  is  a  very  slight  focusing  discrepancy  between  the  different  sides  of  the  intensifier. 
The  re-imaging  optics  were  focused  to  compromise  between  the  difference. 

Three  images  were  taken.  (1)  Intensifier  Dark  Noise  (2)  Room  integration  [LED  turned 
off]  (3)  LED  integration.  Each  image  is  an  addition  of  5  images  to  get  better  statistics. 
Examination  of  the  Room  integration  and  the  LED  integiation  shows  that  the  ambient 
light  in  the  room  accounted  for  about  4%  of  the  light  in  the  LED  integration.  This  is 
important  as  the  ambient  light  in  the  room  is  not  guaranteed  to  be  uniform  over 
the  photocaihode  of  the  image  intensifier.  Profiles  for  these  two  images  are  given 
in  Figure  2.25. 

Examination  of  this  flat-field  image,  shows  a  maximum  non-uniformity  of  around  1.6:1 
which  confirms  our  visual  observation  of  this  being  an  unsually  uniform  tube  (by  VARO's 
specilications).  This  image  (Figure  2.26)  also  clearly  shows  the  results  of  the  image 
intensi-ficr  mask  (Section  2.5.4)  and  the  results  of  ihe  CCD  orientation  (Section  2.1.8). 
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Fgioc  2.2ia  ~  Profile  of  Iniensi/ier  Fbt-Field  image 


Figure  2.25b  -■  Profile  for  Ambient  Light  in  Flat-Field 


Figure  2.26  -  Image  Intensifier  Flat-Field  Image 
[Stretched:  Black  =  290.  White  =  17000) 
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2.5.6  Image  Intensifter  Gain  Calibrations 


There  are  four  gains  for  the  image  intensifier  that  can  be  set  either  via  the  instrument's 
control  panel,  or  by  computer  control.  These  gains  are  notated  as  0,  1,  2,  and  3  going 
from  minimum  gain  to  maximum  gain.  A  calibrated  light  source  was  used  to  adjust  the 
intensifier  gains  by  adjusting  potentiometers  VR5-VR7  on  the  KEO  Interface  board  (see 
Hardware  manual).  The  minimum  and  maximum  gains  are  determined  by  tlie  maximum 
dynamic  range  of  the  image  intensifier  and  is  typically  in  the  neighborhood  of  10.  The 
results  of  the  8/27/93  gain  calibration  are: 


Gain 

ExDOsurc 

Signal-Noisc 

Normalized 

Rado(mini  Ratiofmax) 

0 

10  sec 

3235 

3235 

1 

0.07 

1 

10  sec 

6593 

6593 

2.04 

0.14 

2 

5  sec 

6475 

12950 

4.00 

0.28 

3 

2.5  sec 

11698 

46792 

14.46 

1 

We  notice  from  this  calibration  that  this  particular  intensifier  tube  has  an  unusually  high 
gain  range.  Tfiis  ratio  can  also  be  seen  on  the  Photodiode  calibration  plots  in  Section  2.4. 
Since  the  low  gain  settings  are  used  more  often  (to  reduce  intensifier  noise),  the  Hrst  three 
gains  were  calibrated  to  be  ratios  of  2. 

2.5,7  Intensifier  Dark  Noise 

Similar  to  the  CCD.  the  intensifier  has  dark  current  mostly  associated  with  the  Trialkali 
Photocathodc.  This  dark  current  is  temperature  dependent  as  is  displayed  in  Figure  2.27. 


Figure  2,27  --  Photocathode  Dark  Current 
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There  is  also  image  intensifier  noise  that  appears  as  much  brighter  spots,  called  "ion- 
noise".  This  is  due  to  positive  ions  created  at  the  input  of  the  micro-channei  plates.  There 
is  an  aluminized  layer  on  the  front  of  the  MCP  which  is  designed  to  stop  these  ions  from 
drifting  back  to  the  cathode.  Occasional  ions  are  accelerated  back  into  the  photocathode, 
emitting  a  burst  of  electrons,  creating  a  large  flash  of  light.  When  looking  at  the  output  of 
an  image  intensifier,  it  is  easy  to  distinguish  between  the  two  types  of  noises.  In 
calculating  the  average  dark  current  for  the  image  intensifier,  these  occasional  "ion”  spots 
were  avoided. 

Curves  for  the  intensifier  dark  current  are  shown  in  Figure  2.28.  Notice  that,  similiar  to 
the  CCD,  we  get  about  a  factor  of  2  reduction  m  dark  current  for  every  6°C  of  cooling  tor 
factor  of  10  for  every  20°C  of  cooling).  It  can  be  seen  from  Figure  2.27  above,  that  only 
about  another  factor  of  10  could  be  achieved  by  cooling  the  photocathode  down  to 
about  -20°C.  The  HA  ARP  intensifier  designed  was  chosen  to  cool  to  around  1->5°C  to 
avoid  condensation  on  the  cooler  window.  Typically,  the  cooler  achieves  a  differential  of 
about  20°C. 


0  2  4  6  8  10  12  14  16  18  20 

Temperature  (C) 


Figure  2.28  --  HAARP  Intensifier  Dark  Current 
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The  intensifier  dark  current  .vs.  temperature  was  measured  by  disconnecting  the  Intensifier 
Cooler  TEC  power  and  putting  different  valued  resistors  in  series  to  reduce  the  effective 
cooling  power  of  the  TEC.  The  CCD  was  still  cooled  to  it’s  maximum  during  these 
exposures  and  the  CCD  dark  current  was  subtracted  out  to  get  only  the  contribudon  of 
the  image  intensifier  photocathode. 

2.6  Filters 

Filter  transmission  curves  were  measured  for  the  HAARP  imager  and  are  as  follows: 


Waveleneth  (X) 

%  Transmission 

Width  iA) 

4282 

61.5 

21.9 

4867 

72.4 

28.6 

5300 

68.7 

24.7 

5581 

76.4 

15.8 

6304 

77.3 

15.6 

7778 

70.8 

15.6 

The  Filter  curves  a  shown  in  Figures  2.30  through  2.35. 

A  flat-field  for  the  filters  was 

not  measured  for  this  calibration  due  to  the  difficulty  of 

ahaining  an  accurate  measurement.  In  order  to  measure  this  flat-field,  we  would  need  a 

uniform,  nxinochromatic  light 

source.  Optically,  to 

get  a  lelecentric  uniform  irriage 

projected  on  the  filters,  we  would  need  to  build  a  setup  shown  in  Figure  2.29. 


LIniform 
Monochromatic 
Light  source 


Figure  2.29  —  Optical  Setup  for  flat-fielding  Filters 
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Figure  2.35  --  Transmission  curve  for7778A  Filter 


The  interference  filters  require  an  image  with  a  cone  angle  of  7®  (or  /4).  Two  4  " 
achromat  lenses  could  be  placed  a  distance  of  two  focal  plai.es  apart; 


For /4,  and d  =  4":  F  =  /xd=16’' 

Thus,  a  32"  tube  could  be  build  with  the  two  achromats  at  either  end  of  the  tube  to  get  a 
valid  flat-field  image  at  the  filter  using  a  4"  uniform  lights  source.  8y  adjusting  the 
distances  between  the  light-source  and  the  lenses,  we  could  reduce  the  size  required  ior 
tlie  monochromatic  light-source. 

A  monochromatic  light-source  is  needed  because  the  filter  transmission  has  a  spatial 
variation  across  the  filter.  Thus,  for  a  5577A  line  the  transmission  will  vary  from  point  to 
point  ui  the  filter.  To  measure  this  non-uniformity  would  require  very  narrow-band  fwters 
at  the  light  source.  Such  a  calibration  would  be  very  expensive,  and  was  iioi  attempteti. 


2.7  Spectral  Calibration 

The  HAARP  Imager  was  calibrated  for  spectral  sensitivity  using  KEO’s  Light  Source  #2. 
The  spectral  output  curve  for  the  light  source  is  given  in  Figure  2.36. 


KEO  Light  Sourc*  *2  (STOmA  Oiilu] 


To  calibrate  the  instrument,  the  light  source  was  placed  in  front  of  the  instrument  in  a  dark 
room.  For  each  filter,  five  images  were  taken  and  added  together  using  a  5-10  second 
exposure,  intensifiei  gain  at  1,  CCD  gain  at  LO  and  1x1  binning.  The  light-source  setting 
was  0d6d. 


Wavelength  Image  Background  Signal  x  flOyExp) 


4282A 

3207 

153 

3054 

4867A 

13584 

153 

17908 

5300A 

15039 

134 

29810 

5581 A 

13905 

133 

27544 

6304A 

3278 

99 

22284 

(These  were  taken  MID  gain.  4  second  exposure) 

6304A 

14291 

53 

14238 

7778A 

2585 

53 

2532 

Multiplying  the  filter  transmission  and  %vidth  times  the  light  source's  output,  we  get  the 
following  results; 


Wavelength 

Transm(%) 

Width!  AlDu  rout!  R/ At 

Signal  (R) 

4282A 

61.5 

21.9 

6.83 

92.0 

4867A 

72.4 

28.6 

18.53 

383.7 

5300A 

68.7 

24.7 

27.98 

474.8 

558iA 

76.4 

15.8 

40.60 

490.1 

6304A 

77.3 

15.6 

59.91 

722.4 

7778A 

70.8 

15.6 

30.73 

339.4 

Normalizing  the  light  source  outputs  to  6304A,  we  get; 

Wavelength  Signal _ Relative  Sensitivity 


4282A  0.14  1.10 

4867A  0.80  1.51 

5300A  1.34  2.04 

5581 A  1.24  1.82 

6304 A  1.00  1.00 

7778A  0.18  0.38 
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Relative  Sensitivity  (-ph 


Wavelength  (A) 

Figure  2.37  --  HAARP  Imager  Spectral  Sensitivity 

This  sensitivity  is  a  function  of  the  image  intensifier  photocathode  response  and  closely 
matches  the  curve  for  our  S20ER  phoiocathodc.  It  should  be  noted  that  commercial 
response  curves  are  usually  presented  in  units  of  mA/AVatt  instead  of  photons.  The  above 
data  can  be  scaled  to  these  units  by  dividing  the  relative  sensitivities  by  Uie  wavelength. 
Figure  2.37  show  the  Imager's  spectral  sensitivity  normalized  to  63(X)A  in  terms  of 
photons  detected  at  the  CCD. 


2.8  Temperature  Calibration 

The  temperature  nronitoring  circuits  were  calibrated  for  the  HAARP  imager  4/26/93.  A 
detailed  explanation  of  these  circuits  is  given  in  Section  3.4.1.  The  results  of  the 
calibration  are: 
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Set:  Tref  =  4.01  V 

^DISPL  =  'RTD 

=  2.00MA 

CCD  Measuremcpbi: 
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''rm! 

-4.41V  +  4.01V  = -0.4V 

Vtet* 

-5.72V  +4.01V  = -1.71V 

PEO; 

.868V 

PEI: 

3.49V 

Tntspi.* 

-27.8C 

Tni-spi.: 

-39.4C 

G-U7: 

-2.17 

Gm?: 

-2.04 

ADUp*i/>: 

44  ->  -28C 

179  ->  39.5C 

RTDtbl: 

89.20  X  2  mA  =  .  1784V 
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1 15.30  X  2  mA  =  . 1784V 

Gifli  ^Air- 

24.7 
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TroMP;41.0C 

ADUcAir; 

45 

.ADUpAi/',' 

182 
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FILT  Measurements; 

'^INT- 

-4.85  +4.01  V  = -0.84  V 

-5.41V  +  4.01V  = -1.40V 

PEO: 

1.714V 

PEO: 

2.804V 

Tnis^r.' 

-6.1c 

Tnispi.J 

21.7C 

0^4?: 

-2.04 

G747: 

-2.00 

ADU(-^i  p: 

88  -->  -6C 

ADUfAir* 

144  ->  -22c 

RTDjjil: 

97.650  X  2  mA  =.1953 V 

RTD-fpl: 

108.50  X  2  mA  =  .217V 

Gioi  ^Air- 

24.8 

Gioi  .TAir' 

24.9 

TroMP:  -5.50 

TroMP;  23.t)C 
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87 
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62 


lnttaairn;i 


Filter  Whtd 


.1939  V /2  mA  =  96.95Q 

'^T^meas- 

.2175  V /2  mA  =  108.75^ 

V,..: 

4.85V 

V,o,: 

5.45V 

Gl«|t 

25.01  (Actual  Gain) 

G|oi: 

25.06  (Actual  Gain) 

2.9  System  Vignetting 

As  discussed  in  Section  2.5.5,  a  system  flat-field  was  taken  that  accounts  for  all  system 
non-unifomiities  and  lens  vignetting  from  the  intensifier  back  to  the  CCD.  The  major 
source  of  vignetting  for  the  imager  is  the  front  primary  lenses.  This  vignetting  is  intrinsic 
to  the  lens  design  of  these  commercial  lenses.  The  HAARP  imager  has  two  lenses:  the 
fisheye  and  the  300mm  lens.  System  vignetting  witli  both  these  lenses  was  measured  at 
maximum  apenure  by  setting  up  a  small  light  source  and  then  scanning  this  source  across 
the  field-of-view  of  the  image  in  both  directions.  This  vignetting  is  intrinsic  to  the  lens 
design  of  these  commercial  lenses. 


■8.00  -6. 00  -4.00  -2.00  000  2  00  4  00  6  00  8  00 

Angl* 


Figure  2.38  -  System  Vignetting  with  3(X)mm  Lens 


63 


Normalited  Response 
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Figure  2.39  -  System  Vignctdng  with  Fishcyc  Lens 
In  addition  the  radial  linearity  of  the  fish-eye  was  measured: 


Figure  2.40  --  Radial  Linearity  of  Fisheye  lens 
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2.10  System  Sensitivity 


2.10.1  Theoretical  case  for  a  single  photon 

It  is  usefull  to  understand  the  system  gain  in  terms  of  a  theoretical  photon  being  detected 
at  the  photocathode  of  the  image  intensifier.  The  image  intensifier  gain  is  quoted  at 
90,000.  This  specification  refers  to  a  steady  stream  of  photons  at  2584K  (Tungsten). 
Since  the  quantum  efficiency  of  the  photocathode  is  on  the  order  of  10%,  this  means  that 
each  detected  photon,  must  create  on  the  order  of  900,(XX)  photons  at  the  output  of  the 
tube.  Clomecting  this  for  the  response  of  photons  at  5577A,  we  get  about  180, (XX) 
photons  for  every  detected  photon  (or  a  fifth  the  number  of  photons  from  a  Tungsten 
source  spectral  distribution). 

As  noted  in  Section  2.2,  the  relay  optics  has  an  efficiency  of  around  10%,  so  there  are  only 
18,000  photons  arri\'ing  at  the  CCD.  Taking  into  account  the  quanmm  efficiency  of  the 
CCTD  (-30%),  we  have  about  55(K)  electrons  collected  by  the  CCD.  Because  these 
photons  vnll  be  spread  over  one  to  four  pixels,  we  can  predict  single  photon  events  as  the 
CCD  for  the  different  gain  settings,  and  intensifier  gain  settings: 


■iiiniiin 

ilTiinillll 

ADC  Gain; 

(25e-/ADU) 

(49e-/ADU) 

(91e-/ADU] 

R&ad  Noise: 

I24e-) 

(39e-) 

[63e) 

MAX 

1375-5500 

55  -  220 

28-  112 

15-60 

MIN 

95  -  380 

3-15 

1-8 

1  -4 

MINx2 

190-760 

7-30 

3-  15 

2-8 

MrNx4 

380-  1520 

15-60 

7-31 

4-16 

We  see  that  the  coupling  between  the  intensifier  and  the  CCD  is  probably  marginal  to 
resolve  single  photon  events  for  MINIMUM  intensifier  gain.  Thus,  for  extremely  sensitive 
images  trying  to  resolve  single  photon  events,  the  minimum  coupling  that  should  be  used 
is: 


Intensifier:  MIN  gain  &  CCD:  HI  gain 
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This  confirms  that  LO  gain  should  be  used  to  extend  the  dynamic  range  of  the  A£)C 
conversion  and  used  for  higher  light  levels.  It  should  be  noted  that  the  abo\'e  numbers  are 
estimates  for  photons  created  at  5577A,  and  that  there  would  be  less  photoelectrons  from 
photons  at  other  wavelengths  (sec  Figure  2.37). 

2.10.2  Theoretical  Sensitivity  of  the  HAARP  Imager 

The  following  is  a  simple  and  quick  calculation  of  expected  sensitivity  of  the  HAARP 
system: 

Each  image  pixel  at  the  CCD  translates  to  an  area  at  the  filter,  the  image  diameter  at  the 
filter  of  3.5  "(89mm)  covers  512  CCD  pixels,  so  the  pixel  size  at  the  filter  is 

89/512  =  0.174mm,  giving  a  pixel  area  of  3.0  x  lO"^  cm^ 

The  F4.5  Pentax  lens  collects  from  a  half -angle  of  6.4°  (0. 1 12  radians),  or  a  solid  angle  of 

X  X  [0. 1  lip  =  3.9  X  10’^  steradians 

I  Rayleigh  (R)  of  source  luminance  corresponds  to 

10*  /  4/t  =  7.96  X  10*  photon/cm^  sec  ster 

If  we  assume  a  Quantum  efficiency  at  the  peak  of  the  cathode  spectral  response  of  12%, 
overall  lens  transmission  of  70%,  filter  transmission  of  70%,  and  assume  that  every 
cathode  photoelectron  event  is  amplified  enough  by  the  image  intensifier  to  give  a 
detectable  CCD  response,  then  the  exp)ccted  count  ratc/pixel  at  the  CCD  for  1  R  input  is 

3.0  X  1(H  X  3.9  X  102  X  7.96  x  10^  x  0.12  x  0.70  x  .70 

=  5.5  X  102  counts  /  pixel-sec 

Thus,  for  every  pixel  to  have  1  event  during  a  1  sec  exposure,  the  required  source 
luminance  is  about  1 8R. 
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2.10.3  Sensitivity  Measurements 


To  take  a  specific  example  from  our  calibration,  we  go  through  this  measurement  for 
4867A.  At  this  wavelength,  the  photocathode  (S20ER)  efficiency  is  about  9%,  the  filter 
transmission  is  .724.  We  now  have  a  minimum  source  luminance  of  about 

=  4.2  X  10-^  counts /pixel-sec 

which  gives  about  24R  for  1  event/pixel-sec.  Using  the  KEO  light  source,  we  illuminate 
the  the  imager  with  384R  using  the  4867A  filter.  Images  were  taken  wiL*i  the  Nikon 
camera  lens  stopped  down  to  /ll,  giving  a  source  of  ~5R.  Thus  from  the  above 
estiraatiori,  we  should  see  photon  events  in  about  20%  of  the  pixels  covered  by  the  source. 
If  we  take  an  image  at  /8,  we  would  have  a  source  of  ~-9R  and  would  expect  about  36% 
of  the  pixels  fUled.  An  image  at  /16  would  give  ~2.2R  giving  us  about  9%  of  the  pixels 
frUed 

CaretuUy,  looking  at  these  images  and  using  histograms,  we  can  see  that  these  numbers 
roughly  agree. 


Figuie  2.41  --  4867A  filter,  Int:  0,  CCD:  HI:  Exp:  1  .see  /4  35R-S€C 
[Stretched:  Black  -  22,  White  =  45] 
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Figure  2.42  -  4867A  filter,  Int:  0,  CCD:  HI:  Exp:  1  sec  /8  9R-sec 
(Sireichcd;  Black  =  23.  White  =  32] 


Figure  2.43  -  4867A  filter,  Int:  0,  CCD:  HI:  Exp:  I  sec  /I  I  SR-sec 
(Sirctchcd:  Black  =  23.  While  =  501 
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Figure  2.41  shows  ihe  calibration  setup  for  fairly  good  photon-statistics.  A  35R  source  is 
integrated  for  1  second  giving  a  35R-sec  image.  Note  from  Section  2.10.1,  that  a  single 
5511  k  photon  event  with  the  coupling  Int:  0  and  CCD  gain  at  HI  will  produce  a  signal  of 
3-15  ADU  depending  on  how  many  pixels  the  resultant  photons  cover. 

Figure  2.42  shows  the  sensitivity  of  the  instrument  at  9R-sec  using  a  1  second  exposure. 
Enlarging  the  center  of  the  image  and  carefully  counting  the  pixels  that  have  received 
some  photons,  reveals  a  percentage  of  pixels  filled  on  the  order  of  what  was  predicted  for 
9R-sec  in  Section  2.10.2. 

Figure  2.43  shows  the  sensitivity  of  the  instrument  for  5R-sec  using  a  1  second  exposure. 
This  image  again  confirms  the  results  of  Section  2.10.2.  Note  that  the  intensity  of  each 
photon-event  is  the  same  as  Figure  2.42,  except  that  there  are  about  1/2  as  many  such 
events  in  the  area  of  the  source  (on  the  order  of  -20%). 


Figure  2.44  —  4867A  filter,  Int:  3,  CCD:  HI:  Exp:  1  sec  /II  SR-sec 
(Sfeiched:  Black  =  23.  White  45) 


Figure  2.44  demonstrates  the  increased  coupling  for  single  photon-events  by  increasing 
the  intensifier  gain  by  a  factor  of  14.  From  Section  2.10.1.  we  would  expect  each 
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detected  5577 A  photon  to  give  a  signal  of  around  55  to  220  ADUs.  Comparing  this 
image  to  Figure  2.43,  we  can  see  that  the  ir.creased  coupling  does  increase  the  number  of 
pixels  filled  in  the  source  area  of  the  image. 


Figure  2.45  --  4867A  filter,  Int:  3,  CCD;  HI:  Exp:  1  sec  /16  2R-sec 
(Stretched;  Black  =  23,  White  =  45] 

Figure  2.45  is  a  2R-sec  image  taken  with  a  1  second  exposure  Again,  the  results  of  this 
unage  agree  with  tiic  analysis  in  Section  2.10.2  that  roughly  10%  of  the  pixels  should  be 
filled  with  photon-evcr.ts 

A  5R-sec  image  was  taken  with  the  iniensificr  gain  on  minimum  and  the  CCD  gain  at  LO 
in  which  the  source  was  questionably  detectable.  As  discussed  in  Section  2.10.1,  the 
photon -.•vcfii  coupling  is  weak  in  this  gain  setup,  and  ihu^  decreases  the  perciuved 
sensitivity  of  the  insu-umcnt.  The  fact  that  a  5R-sec  was  rot  really  detectable  at  LO  Gain, 
but  easily  seen  at  HI  Gain  confirms  die  decreased  coupling,  i'or  situations  where  there  are 
very  low  photon  counts,  the  CCD  should  be  used  at  HI  gain. 

Sirniliai  iiaigcs  were  t  ken  for  the  other  filters  on  the  HAARF  imager  tf’  check  sensitivity 
across  t''<  ipcctrum. 
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2.10.4  Sensitivity  for  the  HAARP  Imager 


Quoting  sensitivities  is  always  a  little  bit  of  a  cky  issue.  One  can  define  sensitivity  in 
many  ways.  Topically,  KEO  has  tried  to  dctcn..  nc  the  minimum  source  illumination  that 
is  required  to  visuallv  detect  the  source  object  in  the  image. 

Even  this  signal  to  noise  is  fairly  subjective.  For  this  iow  intensiflcr  gain  image,  statistics 
of  a  box  inside  the  source  area  yields  an  average  pixel  value  of  22.84.  With  the  light 
source  off,  the  average  pixel  value  is  20.79  with  a  Bias  average  of  19.8.  Looking  at  the 
statistics  of  the  same  source  with  the  intensifier  at  nnaxiinurn,  we  get  an  average  pixel 
intensity  of  50.63,  with  the  background  averaging  22.50.  This  says  we  have  a  much  better 
signal  to  noise,  but  actually  it  only  looks  bettei  because  each  photon  creates  a  much 
highe-  pixel  event  at  maximum  gain. 

ttom  the  above  analysis,  it  appeals  that  the  most  significant  measure  of  sensitivity  is 
probably  what  percentage  of  pixels  get  filled  in  the  image.  From  the  analysis  in  Section 
2,10.2,  we  see  that  a  5R  source  at  4867A,  should  fU  about  20%  of  the  pixels.  Figure 
2.4<i  confinns  this  result  and  points  out  that  it  is  fairly  easy  to  visually  detect  a  source  in 
this  situadon.  However,  even  at  2R  (or  9%  of  pixels  filled)  in  Figure  2.45  we  can  see  that 
the  source  is  detectable,  henc^  the  subjeedvity. 

The  minimuin  sensitivity  s  lould  be  a  function  of  the  photocaihode  response,  and  it  was 
nKaiured  for  the  HAARP  imager  at  the  following  wavelengths  and  estimated  at: 
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Chapter  3  Hardware 


3.1  Overview 


The  HAARP  Imager  viewed  as  a  black  box  is  a  very  basic  instrument  There  is  an 
AC  power  input,  and  just  one  cable  that  connects  the  instrument  to  a  computer.  This 
cable  consists  of  two  components  -  communications  and  data.  The  communications  port 
is  an  RS-422  port  set  up  for  9600  Baud,  8  Bits,  1  Stop  Bit,  and  No  Parity.  Thus,  to  any 
connecting  device,  the  camera  looks  like  a  terminal  running  the  FORTH  environment  and 
can  be  treated  as  such.  The  data  component  of  the  cable  has  all  the  data  lines  and  control 
lines  necessaiy  to  transfer  data  to  a  12  hit  digital  input  frame  grabber  board.  In  our  case 
this  frame  grabber  is  Imaging  Technology’s  AFG  board.  The  data  signals  arc: 


D0+/D0-  through  Dll +/D11- 
Pixel  Clock+/Pixel  Qock- 
Line  Enable+/Linc  Enable- 
Frame  Enable+/Framc  Enable 


;  Differential  data  lines 
;  Pixel  Clock 
;  Line  Enable 
Frame  Enable 


The  HAARP  Imager  can  be  thought  of  as  a  standard  terminal,  and  a  somewhat 
generalized  image  data  port.  In  theory,  the  imager  can  be  controlled  by  any  computer  and 
a  wide  array  of  image  processing  boards.  There  are  presently  about  4  or  5  different 
compatible  boards  for  the  IBM  PC  architecture,  as  well  as  boards  available  for  the 
Macintosh  and  VME  based  systems. 


3.2  CCD  Camera  Control  System 

The  CCD  camera  head  was  custom  designed  and  built  for  KEO  by  Advanced 
Technologies  (Tuscon,  AZ).  The  HAARP  conuol  electronics  and  software  were 
developed  by  KEO  to  meet  the  specifications  of  our  HAARP  design  propos.al  and 
integrated  with  the  Advanced  Technologies  system.  The  core  of  the  Advanced 
Technology  design  is  a  4-board/motherboard  located  inside  the  imager  (sec  Block 
Diagram,  Figure  3.1).  The  HAARP  hardware  system  is  siiniliar  to  the  MIP  camera 
developed  by  KEO  Consultants  for  Phillip's  Lab  Ionospheric  Applications  Branch 
(PL/GPIA). 
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I'igurc  3, 1  HAAKl’  Imager  Hardware  Block  Diagram 


7d 


Control  Board  Clod  '‘^iming  CCD  Signal  KEO  Control 

CCA  COA  CCA  CCA 


The  control  board  consists  of  the  system's  processing  units.  A  68HC1 1  embedded 
processor  is  used  as  the  control  computer  for  the  system  (Figure  3.2).  The  68HC11 
handles  all  the  communication  to  the  outside  world  and  all  control  units  inside  the 
HAARP  camera.  The  68HCI 1  talks  directly  to  the  host  computer  via  a  serial  interface.  It 
monitors  temperatures  and  other  analog  parameters  via  its  8  channel  8-bit  ADC.  Using 
it's  multiplexed  parallel  inputs,  the  68HC11,  talks  to  the  DSP  56001  on  the  Advanced 
Technologies  control  board,  and  in  addition  talks  to  the  KEO  Interface  control  board 
which  controls  the  imager's  filter  wheel,  intensifier  and  shutters.  The  DSP  chip  controls 


all  timing  stales  and  control  signals  for  the  CCD  camera  head.  These  signals  are  used  on 
the  Clock/Timing  board  and  then  sen:  to  the  Signal  board  where  they  are  sent  out  to  the 
CCD  camera  head.  The  Signal  board  also  takes  the  imaging  data  and  control  lines 
described  above,  and  sends  them  out  to  the  host  frame  grabber. 


3.3  CCD  Camera  Head 

The  Advanced  Technologies  CCD  camera  head  consists  of  two  sections.  The 
back  part  of  the  unit  contains  all  the  analog  and  interface  electronics  for  the  CCD.  The 
front  pan  of  the  unit  is  an  evacuated  chamber  containing  the  CCD  chip  and  the 
ihermoelectric  cooling  head  (TEC).  The  warm  side  of  the  TEC  is  coupled  to  the  body  of 
the  unit  and  is  cooled  both  convectively  (the  back  section)  and  with  forced  air  (two  small 
fans  in  the  front  section).  The  TEC  can  normally  produce  a  temperature  differential  of 
about  650C. 

The  back  pan  of  the  CCD  camera  head  should  not  be  opened  or  serviced  except 
by  qualified  personnel.  The  front  section  should  NEVER  be  opened.  The  CCD  is 
extremely  sensitive  to  static  and  is  a  very  expensive  device.  The  vacuum  in  the  front 
section  is  extremely  imponant  for  the  operation  of  the  head  both  to  eliminate 
condensation  on  the  CCD  chip  and  for  temperature  insulation.  L'  this  vacuum  is  lost  and 
air  is  let  in,  the  CCD  will  frost  up  with  ice  and  become  unusable.  Opening  the  front 
section  will  void  all  Advanced  Technology  warranties. 

The  CCD  head  electronics  are  critically  set  for  optimum  noise  reduction.  There 
are  many  critical  voltages  set  that  are  tailored  to  our  particular  CCD  and  any  tampering 
with  these  voltages  will  result  in  degradation  in  performance  of  the  CCD.  The  electronics 
should  NEVER  be  disconnected  from  the  CCD  Interconnect  Circuit  Card  Assembly 
(CCA)  except  by  the  most  skilled  engineer  and  under  very  conffollcd  environmental 
conditions 

There  arc  many  test  points  on  these  electronics  cards  with  which  you  can  check 
the  ofieration  of  the  camera  hea'"  It  is  suggested,  however,  that  if  there  is  a  problem,  the 
CCD  head  be  returned  to  Advanced  Technologies  for  servicing. 
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3.4  The  CCD  Chip 


The  HAARP  Imager  uses  a  Photometries  PM516A  CCD.  This  chip  has  a 
516x516  array  of  20pm  pixels  of  which  512x512  are  captured  by  the  firame  grabber.  The 
well  depth  of  the  pixels  is  about  215,000  electrons.  The  PM516  is  set  up  to  operate  in 
MPP  mode  which  is  a  CCD  configuration  that  allows  a  30  times  reduction  in  dark  noise. 
This  is  attained  by  using  a  boron  implant  that  creates  an  intrinsic  voltage  in  the  wells  to 
reduce  dark  noise  buildup.  Specific  performance  of  the  CCD  chip  can  be  found  in 
Section  2.1. 

3.5  KEO  Control  System 

The  KEO  control  system  uses  the  main  processor,  the  68HC11  of  the  Advanced 
Technologies  system,  to  control  all  operations  of  the  HAARP  camera.  The  control 
components  arc: 


Shutter  1  (front) 

Shutter  2  (back) 

Image  Intensifier 
Filter  Wheel 
Temperature  Monitoring 

Intensifier  Average  Brightness  (detector  located  in  Shuner  2) 

All  these  components  are  controlled  via  software  in  the  FORTH  environment  and 
executed  by  commands  from  the  host  computer.  ITie  68HC11  then  passes  on  the 
appropriate  command  signals  to  the  KEO  Interface  control  card,  which  is  the  fourth  card 
on  the  motherboard. 

3.6  KEO  Control  Interface  Card 

The  Interface  card  is  arranged  in  two  sections:  analog  and  digital  control.  The 
analog  section  consists  o^  fiv:  analog  amplifiers  monitoring  the  following: 

CCD  temperature  Filter  Wheel  temperature 

TEC  temperature  Intensifier  tem|>craturc 

Intensifier  btightness 
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These  voltages  are  scaled  to  0-5V  and  arc  always  present  to  the  analog  digital  convener 
(ADC)  inputs  of  the  68HC11  (PortE).  A  detailed  description  of  the  temperature 
amplifiers  will  follow.  The  analog  section  also  supplies  a  2  mA  constant  current  source 
(OP37)  for  the  four  RTD  s  :nsors.  The  sensors  are  connected  in  series  and  hence  any 
break  in  the  circuit  will  result  in  none  of  the  RTD's  working.  There  are  three  jumpers 
on  both  the  Interface  board  and  the  control  panel  CCA  to  bypass  selected  RTD's  and 
isolate  different  circuits.  The  analog  section  also  creates  two  reference  voltages  to  scale 
the  temperature  voltages. 


The  digital  section  of  the  board  consists  mainly  of  controls  for  the  filter  wheel  and 
the  image  intensifier.  There  is  an  address  decoding  generic  array  logic  device,  GAL 
(U15),  which  interfaces  the  board  to  the  68HC11.  The  image  intensifier  circuit  selects 
from  either  computer  control  or  manual  control  one  of  four  50K  variable  resistors  (VR5- 
VR7)  used  by  the  image  intensifier  to  set  the  HV  gain  of  the  tube. 


The  filter  wheel  control  consists  of  an  embedded  stepper-motor  controller  chip 
(U8)  which  contains  an  EEPROM  (U17)  with  the  control  program.  There  arc  interface 
electronics  which  select  3  bit  commands  either  from  the  68HC1 1  or  manually  from  the 
control  panel  to  select  the  filter  wheel  position.  An  EPROM  (U7)  constantly  monitors  the 
state  of  both  this  command  input  and  the  filter  wheel  position  and  when  there  is  a 
difference  issues  the  appropriate  movement  command  to  the  CY545  controller  (U8) 
which  then  steps  the  filter  wheel  into  the  new  jxisition. 


Presently,  the  EEPROM  program  just  stops  if  there  is  a  problem  with  the  position 
or  the  command  location.  The  logic  behind  this  is  that  if  there  is  a  problem  in  either  of 
the  systems,  we  do  not  want  the  controller  to  endlessly  try  and  position  the  stepper  motor 
and  perhaps  result  in  a  catastrophic  failure.  (We  could  add  a  control  line  from  the 
68HC11  that  can  position  the  filter  wheel.  This  would  give  an  independent,  host- 
controlled  system  to  control  the  filter  wheel  in  the  event  of  some  failure  in  the  interface 
electronic.-..]  There  is  a  reset  switch  for  the  CY545  Stepper  Motor  controller  located  on 
the  Interface  Board, 


77 


The  Luerface  Board  is  delivered  with  the  following  jumper  settings: 


J1  -  OUT 
J2  -IN 
J3  -  OUT 
J4-IN 


;  Control  Panel  RTD  Excitation  Cunent  Bypass 
;  RTD  Excitation  Current  Source 
;  CCD  Head  RTD  Exciution  Current  Bypass 
;  Analog  and  Digital  Ground  Common  Point 


3.7  Control  Panel 

The  control  panel,  which  is  accessible  from  the  outside  via  a  magnetically  closed 
panel  cover,  contains  the  filter  wheel  temperature  controller,  and  all  the  electronics  to 
manually  control  the  shutters,  the  image  intensifier,  the  filter  wheel.  All  the  power 
supplies  and  system  temperatures  can  be  monitored  on  the  control  panel.  In  addition, 
there  is  an  opto-isolated,  voltage  shifting  interface  which  sends  the  shutter  and  stepper 
motor  control  signals  to  the  KEO  Power  I/O  board.  This  interface  isolates  any  power 
supply  noise  of  the  shutters  and  stepper  motors  from  the  analog  voltages  which  are  used 
in  the  CCD  camera  head  (and  are  vcr>'  noise  sensitive). 

3.8  Power  I/O  board 

The  Power  I/O  board  has  the  shuncr  drivers,  the  stepper  motor  drivers,  and  a  12V 
supply  for  the  CCD  cooling  fans.  Both  the  HAARP  and  the  MIP  Imagers  have  been 
upgraded  to  use  the  Power  I/O  Rev.A  Board.  There  are  five  fuses  on  the  circuit  board  to 
protect  the  input  transformer  (AC),  each  of  the  shutter  coils  (32  V  peak,  4V  holding)  and 
stepper  motor  coils  (24V  unregulated).  During  parked  modes  for  the  filter  wheel,  the 
coils  are  turned  off  via  the  Stop  interface  signal  and  the  intrinsic  friction  of  the  motor  and 
gears  is  used  to  hold  the  in  place.  This  saves  on  heat/power  dissipation  of  both  the 
driver  (UCN5804B)  and  the  stepper  motor  coils  (each  24V  @  lA  or  48W). 

The  RevA  version  of  the  Power  I/O  board  has  diodes  between  the  UCN5804B  and 
the  StepperMoror.  This  was  necessitated  by  a  change  in  the  manufactured  configuration 
of  the  UCN5804B.  In  addition,  dropping  resistors  were  inserted  berween  the  shutter  and 
the  shutter  supply  to  allow  for  different  shutter  coil  rcsistance.s  (i.e.  switching  from 
UniBlitz  shutters  to  Mellcs-Griot). 
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3.9  Filter  Wheel 


The  HAARP  filter  wheel  has  three  basic  components:  stepper  motor,  position 
monitoring,  and  temperature  control.  The  stepper  motor  connects  directly  to  the  Power 
I/O  board.  The  HAARP  Imager  has  been  set  up  using  the  stepper  motor  on  the 
filterwheel  in  half-step  mode,  which  increases  resolution  and  results  in  much  smoother 
operation,  'fhis  modification  directW  pulled  pin  10  of  the  UCN5804B  on  the  PowcrI/0 
boaid  up  to  Vcc  (or  pin  16). 

The  position  monitoring  electronics  involves  four  transmission  switches.  These 
are  connected  to  the  control  panel  ana  then  to  the  KEO  Interface  Control  C^d.  There  are 
three  position  switches  which  give  a  3  bit  position  code:  1-5.  The  fourth  transmission 
switch  gives  a  pulse  for  every  filter  position  and  is  used  to  clock  the  position  code  into  D- 
flip-flops  and  subsequently  into  the  command  EPROM.  In  addition,  there  is  an  RTD 
used  to  monitor  the  FW  temperature.  This  signal  returns  to  the  Control  Panel  CCA  where 
an  instrumentation  amplifier  (U13)  amplifies  it  and  sends  it  to  the  KEO  Interface  Control 
CCA. 


On  the  front  of  the  filter  wheel  is  a  connector  that  has  a  mating  photoconductivc 
cell.  This  is  used  to  inhibit  the  image  intensifier  power  supply  from  switching  on  in  the 
event  of  too  much  ambient  light.  The  sensitivity  of  this  light  detector  can  be  set  by 
adjusting  the  IM  pot  on  the  KEO  Control  Panel  CCA  (VRl) 

The  temperature  control  consists  of  a  REX  Cl 00  temperature  control  unit  and  is 
independent  of  the  KEO  interface  electronics.  An  RTD  is  connected  in  the  Lhrce  wire 
configuration,  and  the  outputs  of  the  REX  ClOO  connect  to  an  SSR  inside  the  Imager 
chassis  and  subsequently  to  an  AC  heater  pad  glued  to  the  inside  of  the  filter  wheel.  For 
operation  of  the  REX  ClOO,  see  the  REX  ClOO  user's  manual. 

3.10  Image  Intensifier  Control 

The  image  intensifier  is  housed  inside  a  thermo-electrically  cooled  housing  that 
cools  only  the  input  cathode  to  about  25®C  below  ambient,  thus  reducing  image 
intensifier  dark  current  by  a  factor  of  about  10-15.  There  are  gas  connection  fittings  on 
the  side  of  the  image  intensifier  cooler  lo  flush  the  input  window  and  image  intensifier 
fiber  optics  input  with  dry  N2  m  case  of  condensation  in  humid  environments. 
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Note:  Due  to  a  fabrication  error  b}  Products  for  Research,  the  connectors  to 
the  HAARP  Intensifier  Cooler  are  different  than  the  MIP  Intensifier  Cooler. 
Because  of  this,  the  two  coolers  are  NOT  directly  interchangabie. 

Power  to  the  TEC  comes  from  a  Photometries  unregulated  TEC  supply.  RTD 
connections  are  routed  into  the  power  cable  on  the  intensifier  housing  labelled  PWR  and 
connect  to  the  KEO  Control  Panel  CCA  where  an  instrumentation  amplifier  (U14) 
amplifies  its  signal  and  sends  it  to  the  KEO  Interface  Control  CCA.  The  image 
intensifier  is  a  25mm  Genii  VARO  tube  and  connects  to  the  KEO  Control  Panel  CCA  via 
the  housing  connector  labelled  INT. 

The  intensifier  cable  has  the  standard  4  wires  to  connect  to  an  image  intensifier  - 
Power,  Gnd,  and  two  gain  connections.  The  intensifier  has  4  gain  settings,  0-3,  which 
can  be  controlled  either  b  the  computer  or  via  the  manual  controls  at  the  HAARP 
Imager.  The  power  is  supplied  by  a  3V  supply  on  the  KEO  Control  Panel  board  and  the 
ground  returns  through  a  5  Ohm  resistor  which  monitors  the  actual  current  through  the 
intensifier  and  activates  an  LED  on  the  control  panel.  (An  improvement  would  be  to 
connect  this  to  a  TTL  status  signal  to  the  host  via  the  68KC11  interface.)  The  gain 
signals  return  to  the  KEO  .Inicrface  Control  CCA  and  goes  through  the  currently  selected 
50K  potentiometer. 

3.11  Shutters 

There  are  two  shutters  in  the  HAARP  system.  Shutter  1  is  defined  as  the  front 
shutter,  closest  to  the  filter  wheel,  and  blocks  light  to  the  front  of  the  image  intensifier. 
Shutter  2  is  defined  as  the  shutter  closest  to  the  CCD  head  and  blocks  light  to  the  CCD. 
The  shutters  can  be  controlled  either  by  the  computer  or  manually.  The  shutters  are  each 
fused  with  a  lA  SB  fuse  to  protect  the  .shutter  coil.  Tlie.se  fuses  are  located  on  the  Power 
I/O  board  in  the  Imager. 

The  shutters  used  in  the  HAARP  Imager  are  Mcllcs-Grioi  #04-IE.S005  shutters, 
and  are  at  a  location  in  the  optical  path  so  as  to  minimize  exposure  .spatial  non-uniformity 
resulting  from  the  finite  shutter  speed.  Each  shutter  has  two  connectors:  one  for  the 
solenoid  and  micro-switch,  and  one  for  a  photo-diode  amplifier  board.  Only  the  back 
shutter  (Shutter2)  has  a  photodiixlc  amplifier  connected.  This  is  used  to  measure  the 
luminance  of  the  intensifier  phosphor 
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The  Mclles-Grioi  shuner  control  uses  a  f  V  Relay  to  open  and  close  its  blades. 
The  shutter  is  specified  at  ~4x  opening  voltage  and  l/2x  holding  voltage.  The  KEO 
Powerl/O  board  creates  a  32V  (unregulated)  80  msec  pulse  using  a  timer  (Ul)  and  the 
UCN2944  Supply  side  driver  (U2).  The  holding  current  is  supplied  by  the  LM317 
voltage  regulator  and  is  set  for  around  5.5V,  giving  a  holding  current  of  about  3.5V  after 
tlie  Darlington  and  diode  voltage  drops  in  the  electronics. 

On  the  Power  I/O  board  Rev.A,  there  are  also  dropping  resistors  between  the 
supply  and  the  shutters  giving  an  additional  voltage  drop  to  the  shutter.  The  HAARP 
Imager  has  3.0Q  dropping  resistors  which  bring  the  final  starting  pulse  voltage  from  24V 
to  16V  and  the  holding  voltage  from  3.5V  to  2.4V.  (This  drop  from  the  original  specs  of 
the  Power  I/O  board  is  needed  because  we  changed  from  the  UniBlitz  shutter  which  had  a 
12.5f2  coil  to  the  Melles-Griot  which  uses  a  70  coil.) 

A  micro-switch  is  mounted  inside  the  shutter  so  that  it  closes  when  the  shutter 
blades  are  fully  open.  This  shorts  to  ground  a  circuit  on  the  KEO  Control  Panel  CCA 
which  puts  out  a  TTL  signal  and  also  controls  an  LED  display  on  the  control  panel,  'fhus 
there  is  visual  feedback  as  to  whether  the  shutter  is  open,  and  a  TTL  signal  which  is 
returned  to  the  68HC11  processor  and  can  be  read  by  the  Host  for  a  shutter  status 
indication. 

The  photodiode  output  is  amplified  by  an  AD515  amplifier  which  must  be  located 
very  near  the  photodiode  because  of  the  low  currents  being  measured  (pA).  The 
photodiode  was  selected  for  its  relatively  fast  response  and  fast  dark  decay  time.  The 
output  of  the  AD515  is  returned  to  the  KEO  Interface  Control  CCA  via  the  KEO  Control 
Panel  CCA  and  is  amplified  with  variable  gain  (VR4  on  U9)  and  sent  to  the  ADC  port  of 
the  68HC11  (PE4).  This  variable  resistor  is  set  so  that  5V  corresponds  to  the  image 
intensifier  operating  in  AGC  mode.  Reading  this  photodiode  gives  the  Host  a  measure  of 
the  average  luminance  of  the  image  intensifier  phosphor  and  from  this  analog  information 
it  can  then  be  decided  what  exposure  and/or  gain  is  most  appropriate  for  the  next  image 
acquisition.  It  also  allows  the  Host  confirm  that  the  intensifier  is  not  operating  in  the 
AGC  mode  where  intensifier  output  is  no  longer  linear  with  light  input. 

Keeping  Shutter  )  closed  during  the  exposure  allows  the  Host  to  obtain  a  dark 
image  that  includes  both  the  daik  noise  of  the  CCD  and  the  image  intensifier.  During  a 
normal  exposure,  the  front  shutter  is  opened  first  and  checked.  The  Intensifier  brightness 
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is  then  checked  to  make  sure  that  it  is  operating  in  its  linear  region.  Finally,  the  back 
shutter  is  opened,  checked  and  the  exposure  interval  begins.  At  the  end  ot  the  exposure 
interval,  bo»h  shutters  close  simultaneously  and  arc  checked. 


3,12  Power  Supplies 

AC  power  for  the  HAARP  Imager  is  supplied  to  four  separate  transfoimeis: 

(1)  REX  Cl 00  power  supply 

(2)  5V,  +/-15V  power  supply  transformer 

(3)  TEC  Unregulated  power  supply 

(4)  KEO  Powerl/O  CCA  power  supply 

(1)  The  REX  ClOO  is  fused  with  a  lA  SB  fuse.  It’s  power  consumption  is  only 
15VA  but  AC  to  the  REX  ClOO  also  supplies  the  Filter  Wheel  heaters. 

(2)  The  5V,  +/-15V  power  supply  transformer  is  taken  from  a  PowerOne  power 
supply  and  is  rated  at  5V  @3A,  +/-15V  <5)1  A.  The  transformer  is  fused  with  a  lA  SB 
fuse.  The  5V  regulator  is  mounted  vertically  inside  the  HAARP  chassis  and  the  +/-15V 
regulator  board  is  mounted  in  the  box  on  top  of  the  chassis  with  the  regulators  heat  sinked 
directly  into  the  HAARP  chassis  from  the  inside. 

(3)  The  TEC's  in  the  HAARP  are  powered  by  a  Photometries  unregulated  power 
supply  and  fused  at  lA  SB.  To  handle  both  TEC's,  the  input  coils  of  Uic  transformer  are 
connected  in  parallel  to  increase  the  current  capacitity  of  the  power  supply.  The  image 
intensifier  TEC  and  the  CCD  TEC  together  draw  about  8A  at  around  7.5VDC.  They  are 
connected  in  parallel  to  the  output  of  die  power  supply. 

(4)  The  KEO  Power  I/O  CCA  has  a  20VAC  56VA  transformer  and  is  fused  on 
the  circuit  board  with  a  lA  SB  fu.se.  When  drawing  no  current,  the  DC  unregulated 
power  supply  charges  up  to  about  32-35VDC.  This  is  used  as  a  starting  pulse  for  the 
shutters.  The  stepper  motor  draws  lA  per  phase.  At  2A,  the  unregulated  power  supply 
puts  out  2AYDC  (which  is  the  voltage  specified  for  the  motor).  There  are  also  two 
LM3 17  voltage  regulators.  U4  is  set  to  5.75V  and  is  used  for  the  CMOS  logic  supply  and 
shutter  holding  voltage.  The  shutter  coils  are  7  Ohms,  so  at  2.4  V  they  each  draw  340mA. 
RIO,  R1  lA  &  R1  IB  are  used  reduce  die  input  voltage  from  32VDC  so  that  the  LiViii  / 
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doesn't  dissipate  as  much  heat.  U5  is  set  to  12V  and  is  used  to  power  two  DC  fans  (.lA 
each)  connected  in  parallel,  and  used  to  cool  the  CCD  head. 

3.13  Back  Panel 

The  back  panel  has  two  connectors:  AC  and  Computer  Interface,  The  AC  plugs 
into  any  1 10-120VAC  outlet.  The  Computer  Interface  connecter  contains  all  the  signals 
for  the  RS-422  communications,  as  well  as  the  12  bit  digital  image  and  clocking  signals. 
All  signals  on  this  cable  are  differential  which  allows  longer  transmission  distances  and 
noise  immunity.  The  main  power  fuse  for  the  HAARP  Imager  (2 A  SB)  is  located  on  the 
back  panel.  A  power  on/ofF  switch  is  also  located  on  the  back  panel. 

A  recessed  red  button  is  located  by  the  Interface  connector.  This  is  the  reset 
button  for  the  68HC11  processor  inside  the  HAARP.  Pushing  this  will  reset  all  the 
electronics  and  bring  the  instrument  up  in  it's  initial  state.  Some  of  the  electronics  that 
are  indei>endent  to  the  processor  will  not  be  reset  by  this  button,  and  you  may  need  to 
actually  turn  off/on  to  achieve  a  full  reset. 

3.14  Temperature  Monitoring  Equations 

The  KEO  Interface  Control  CCA  provides  a  2mA  excitation  current  for  the  RTDs. 
The  8  bit  ADC  (0  to  5V)  gives  256  steps.  If  the  resolution  is  O.S^C,  then  the  range  is 
1280C. 

Temperature  Range:  -SO^C  to 

DIN  RTD  curves:  R(-.50oC)=80.3f2  R(78oC)  =130.1D 

0  to  5  Volts/1 28C  =  38  mV/oC. 

With  2mA  cxcitarion:  VC-SCy’C)  =  .161  Volts,  V(780C)  =  .26  Volts 

V(780C)  -  V(-500C)  =99  mV. 

Set  overall  system  gain  to  50.  LF347  Gain  -  2.  1 N 101 A  Gain  =  25 

Gain  of  1  NIOl A  =  1  +  40K/Rg:  Rg  =  1 .67KD 

Vief  =  .16  Volts  X  25  =  4.02  Volts  Offset  for  LF347  to  scale  -4.02  V  to  0  Volts 
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To  display  the  temperature  on  the  HAARP  Control  Panel,  an  ACCULEX  DP350 
DVM  is  used.  The  inputs  to  the  68HC11  ADC  are  scaled  10inV/°C  to  read  degrees 
centigrade.  So  -SO^C  =  SOOinV  or  0.5V.  The  decimal  point  of  the  meter  is  shifted  right 
two  places  so  the  meter  actually  displays  degrees  Celsius. 

0  -  5  VDC  =  -.5V  to  +.78V  Gain  =  .256 

An  LF347  (U6)  on  the  Control  Panel  CCA  with  R2/R1  =5.1  lKD/20Kn  =  .255 
An  offset  voltage  is  needed  to  scale  OV  down  to  -.5Volts: 

.5/. 2555  =  1.96V  LF347  (U9)  on  Interface  CCA  using  VRl  to  set  offset. 
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Chapter  4  Image  Processing  System 

The  HAARP  Imager  runs  on  an  IBM  AT  system  under  the  Windows  3.1 
C)i>erating  System.  The  casual  user  should  not  have  to  know  any  details  of  how  the 
camera  works,  so  this  section  will  mainly  focus  on  the  computer  and  image  processing 
systems. 

Since  the  HAARP  software  runs  under  Windows  3. 1,  it  is  fairly  user-friendly.  The 
operator  should  be  able  to  become  proficient  in  the  basic  operations  without  a  detailed 
knowledge  of  the  system  software.  However,  it  is  suggested  that  to  obtain  maximum  use 
out  of  this  powerful  system,  the  interested  user  should  become  familiar  with  the  following 
systems: 


DOS  5.0 

MS-DOS  R^erence  Manual 

Windows  3.1 

Windows  3.1  Reference  Manual 

m  Adv.  Frame  Grabber 

m  AFG  Software/ Hardware  manual 

ITEX  V22-2  Release  Notes 

Camera  Svstem 

Suggested  Reading 

HAARP  Camera 

HAARF  Hardware  R^erence  Manual 

MaxFORTH 

MaxFORTH  User  Manual 

68HC1 1 

Motorola  68HC 1 1  User  Manual 

DSP56001 

DSP56001  User's  Manual 

4.1  Overview: 


The  HAARP  Imager  can  be  thought  of  as  composed  of  two  separate  components: 
the  camera,  and  the  image  processing  system.  The  camera  is  controlled  by  the  image 
processing  system  through  a  control  program  called: 

MIPCTL 

It  is  also  possible  to  control  the  camera  with  any  commujiications  program  if  the 
communications  protocol  is  set  as  follows: 
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9600  Baud  8  Bits  1  Stop  Bit  No  Parity 


The  camera  has  an  RS-422  serial  pon  which  is  connected  to  a  serial  board  in  the  computer 
to  COM4.  The  printer  port  is  set  up  for  COM2.  Both  these  ports  arc  labelled  on  the  back 
of  the  computer. 

The  image  processing  system  is  centered  around  hardware  called  the  Advanced 
Frame  Grabber  (AFG)  made  by  Imaging  Technology.  This  is  a  two  board  set  with  a 
daughter  board  that  resides  inside  the  IBM  AT  computer.  This  board  is  controlled 
through  the  program  MIPCTL,  and  it  can  also  be  controlled  manually  through  the  ITEX 
Interpreter  (INTRP)  supplied  with  the  board.  The  camera  can  thus  be  controlled  by  using 
both  a  communications  program  and  INTRP  in  tandem.  This  can  be  useful  in  developing 
new  algorithms,  or  in  being  able  to  take  data  in  a  way  that  the  MIPCTL  docs  not  support. 

The  control  program  MIPCTL  sets  up  the  communications  with  the  camera  and 
enables  the  user  to  control  all  the  basic  features  of  the  camera.  In  addition,  this  program 
gives  a  set  of  commands  for  the  AFG  board  and  data  acquisition  and  analysis  functions. 
The  MIPCTL  program  is  viewed  as  an  evolutionary  program,  and  it  is  expected  that  it  will 
be  developed  further  to  add  extended  functionality  as  dictated  by  experience  and  field  use 
situations. 

4.2  IBM  AT  Image  Processing  Hardware: 

The  HAARP  Image  Processing  System  is  based  upon  an  IBM  486  processor.  A 
Gateways2000  486DX2/50MHz  machine  is  used,  but  any  AT  system  with  a  386  or  greater 
would  be  satisfactory.  The  following  is  a  brief  description  of  the  AT's  hardware 
configuration. 

Ropp^iPisl^ 

Both  a  3.5"  and  5.25"  floppy  disk  are  mounted  in  the  system.  The  HAARP  IP 
System  uses  a  dual  1/2  space  3.575.25"  TEAC  floppy  drive  FD-505  supplied  by  JDR 
Microdevices  configured  for  the  default  operation  A:  1.2MB  and  B:  1.4MB. 
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A  RICOH  Magneto-Optical  Drive  RO-5031E  (SN:  K9101148)  with  a  SCSI 
interface  is  mounted  internally.  This  is  fully  compatible  with  the  ASIPII  Optical  Disk 
system  and  the  MIP  Optical  Disk  System  on  other  Air  Force  GL  imagers  which  both  use 
the  SONY  M/0  drive.  Because  of  the  increased  rotational  speed  of  the  RICOH  drive,  it  is 
recommended  by  RICOH  that  only  SONY  media  be  used  with  this  drive  (EDM-lDAOs: 
1024Bytes/scctor,  650MB  optical  disks).  The  RICOH  drive  is  untcrrainated  as  there  is 
also  a  hard-drive  connected  to  the  SCSI  port  in  the  HAARP  IP  System. 

An  APT  Odessa  SCSI  interface  board  (SC  1000)  is  used  to  interface  the  optical 
disk  to  the  AT.  This  is  fully  DOS  compatible  and  can  be  used  as  any  other  drive  in  the 
system.  The  SCIOOO  is  installed  using  IRQIO  and  memory  address  segment  D600:0000. 
The  Odessa  system  comes  with  drivers  MOD.SYS  and  MOD.EXE.  The  HAARP  Imager 
has  vl.26  installed.  The  switch  option  /4  should  be  used  when  running  MOD.EXE  which 
utilizes  the  smaller  cluster  sizes  (8192)  of  DOS4.01  and  greater.  M.BAT  assures  that  this 
switch  is  used. 

A  650MB  MO  disk  can  hold  about  2400  2x2  binned  images  per  side  (1/8MB  per 
image)  or  about  600  1x1  binned  images  per  side  (1/2MB  per  image).  On  the  HAARP 
computer  system,  the  MO  drive  is  set  up  to  start  partitions  at  drive  E: 


An  addidonai  hard  drive  was  installed  into  the  HAARP  imager  to  allow  for  rapid 
image  processing  of  large  data  sets.  The  766MB  hard  drive  has  enough  room  to  store  two 
sides  of  an  M/0  disk  (or  one  side  of  raw  data  and  it's  associated  transformed  images).  This 
disk  was  also  installed  to  assure  backup  in  the  event  of  the  IDE  Hard  Drive  or  the  RICOH 
MO  drive  failing.  Another  use  for  this  drive  is  to  collect  large  amounts  of  data  quickly 
when  the  write-time  of  the  RICOH  MO  drive  is  too  long  to  take  'real-time'  data.  After  the 
data  has  been  taken  on  the  SCSI  hard  drive,  it  can  be  backed  up  onto  the  MO  disk  when 
time  is  not  criticaJ. 

A  Seagate  WREN  6  SCSI  drive  (ST4766N)  was  chosen  for  the  HAARP  imager 
and  installed  internally  in  series  with  the  RICOH  MO  disk.  This  disk  is  terminated  as  it  is 
the  last  drive  in  the  SCSI  chain.  The  ST4766N  is  a  full-height  disk  drive. 


This  drive  can  hold  about  5800  2x2  binned  images  (1/8MB  per  image)  or  about 
1450  1x1  binned  images  (1/2MB  per  image). 

200  MB  IDE  Hard  Drive  and  I/O  Pons: 

A  200  MB  Hard  Drive  is  mounted  internally  in  the  system  with  an  IDE  controller 
(DPI  EDEIO).  This  controller  also  has  provisions  for  the  parallel  interface  brought  out  to 
the  back  of  the  computer  and  two  serial  interfaces  set  up  as  COMl  and  COM2.  COMl  is 
currently  set  up  for  a  serial  Microsoft  Mouse,  and  COM2  is  accessible  for  peripherals  such 
as  a  serial  printer. 

RS-422  Serial  Interface  Board: 

A  B«&B  Electronics  3PXCC1A  IPORT  RS-422  Board  is  used  to  interface  to  the 
HAARP  Imager.  This  board  was  chosen  because  it  allows  the  selection  of  any  available 
I/O  address  for  the  COM  address  rather  than  the  standard  COM  port  addresses.  In 
addition,  it  allows  selection  of  IRQ's  up  to  IRQ15.  This  flexibility  is  needed  in  the  HAARP 
IP  System  because  the  VGA  board  supplied  in  the  Gateways  486  (ATI  Ultra)  uses  the 
COM4  I/O  address  for  it's  own  purposes. 

The  3PXCC1A  was  installed  using  COM4  (S)  IRQll,  and  the  I/O  address  Ox3iO. 
The  COM4  settings  must  reflect  this  under  Windows  3.1  in  order  for  this  to  work. 

Gateways  Telcpath  Modem/Fax  Board: 

A  Gateways  Tclepath  3.5  Modem/FAX  board  was  installed  in  the  HAARP  IP 
System  and  allows  up  to  14.4KBaud  Modem  communications  and  96(X)Baud  Send/Receive 
FAX  capabilities.  The  Telepath  is  installed  at  COM3,  IRQ5  and  has  both  communications 
and  FAX  software  installed  with  it.  For  Windows  3.1  users,  CrossTalk  for  Windows 
(communications)  and  WinFax  (Faxing)  can  be  used. 
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The  HAARP  has  an  ATI  Ulira  Board  with  1MB  of  Video  RAM  installed,  which  has 
a  resolution  of  up  to  1024x764.  The  output  of  the  VGA  board  is  sent  to  the  video  mixing 
input  connector  on  the  AFG  board. 

\dvanced  Frame  Grabber  (AFGl  Image  Processing  board: 

This  two  board  set  contains  all  the  image  processing  and  display  hardware  for  the 
HAARP  Imager.  The  model  number  for  the  AFG  board  ordered  for  HAARP  is:  VP1510- 
KIT-512-U-C1-M3-AT.  A  GSP  chip  (TMS34010)  controls  all  the  display  and  system 
interface  functions  on  the  board.  Tliis  GSP  has  2MB  of  system  memory  of  which  about 
.5M  is  cunendy  used.  2MB  of  video  frame  mentory  (lKxlKxl6)  make  up  the  frame 
buffer.  Four  multiplexed  RS-170  inputs  and  one  12  bit  digital  input  port  are  available  on 
the  board.  The  12  bit  digital  input  port  is  used  for  the  HAARP  Camera  head.  The  AFG 
also  has  an  extensive  hardware  Arithmetic  Lx>gic  Unit.  It  is  recommended  that  the  user 
read  the  AFG  Hardware  and  Software  Introductions  to  become  familiar  with  the  board’s 
capability.  A  block  diagram  of  the  AFG  board  is  shown  in  Figure  4.1. 


Figure  4.1  --  AFG  Block  Diagram 
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The  AFG  has  a  daughter  board  that  mixes  the  VGA  from  the  VGA  board  with  the 
output  display  from  the  AFG's  frame  buffer.  This  output  must  go  to  a  muld-sync  monitor 
such  as  the  NEC  3FGx.  Using  this  VGA  mbdng  board,  one  monitor  can  be  used  to  view 
both  the  image  display  and  the  computer's  screen.  A  key  color  is  set  up  to  choose  how  to 
mix  both  displays.  Two  displays  can  also  be  used  at  any  time  for  greater  flexibility. 

NEC  3FGx  Monitor: 

The  NEC  3FGx  is  a  15"  Multi-sync  Flat-Screen  display  capable  of  up  to  1024x768 
resolution.  It  is  presently  set  up  for  VGA  display  (640x480).  The  NEC  3FGx  monitor 
delivered  with  the  HA  ARP  Imager  is  Model  #:  JC1532VMA-N  and  SN;  22M24855A. 

Gateways  2000  486  Computer: 

The  computer  runs  an  Intel  486DX2  processor  at  50MHz  with  8MB  of  RAM. 
DOS  5.0  and  Windows  3. 1  are  installed  on  the  system.  DOS  6.0  is  provided  with  the 
system  if  an  upgrade  is  desired.  It  is  recommended  that  the  operator  become  familiar  with 
these  operating  systems  (especially  Windows). 


43  Understanding  the  Image  Processing  System 

4.3.1  AFG  Hardware  Specifics 

Hardware  of  the  Image  Processing  System  is  mostly  defined  by  the  frame  grabber 
board;  the  Advanced  Frame  Grabber  from  Imaging  Technology  (henceforth  referred  to  as 
the  AFG).  It  is  extremely  beneficial  to  have  a  basic  understanding  of  this  board  and  the 
ITEX  documentation  has  a  good  introduction  into  both  the  hardware  and  the  software  for 
the  board,  especially  Chapter  3  of  the  Hardware  Manual. 

The  AFG  Board  has  a  1024x1024  pixel  frame  buffer  with  16  bits  depth.  The  lower 
12  bits  are  used  to  store  the  image  information,  and  the  upper  4  bits  are  used  for  graphic 
overlays  such  as  image  labelling,  lines,  graphs,  etc.  In  this  way,  the  image  labelling  does 
not  affect  the  integrity  of  the  data.  There  are  times  however,  when  one  would  like  to  use 
all  16  bits  of  the  frame  buffer  for  image  data,  such  as  when  adding  ten  12-bit  images 
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together  to  take  an  average.  Care  then  has  to  be  taken  when  using  the  frame  buffer  to 
know  exactly  what  section  you  are  using  and  what  is  presently  available. 

The  version  of  the  MIPCTL  software  delivered  with  the  HAARP  IP  System  has 
provision  for  doing  all  image  overlay  and  graphics  in  a  super-imposed  VGA  window  so 
that  none  of  this  data  is  being  written  into  the  frame  buffer  memory.  This  insures  the 
integrity  of  all  16  bits  of  image  memory. 

4.3.2  Image  Definitions:  General  Area  of  Interest  (GAOI) 

An  area  defined  in  this  frame  buffer  is  called  a  "General  Area  of  Interest"  or 
abbreviated  as  GAOI.  There  are  defined  GAOI's  that  are  used  in  the  MIPCTL  application 
that  are  useful  to  know.  The  frame  buffer  is  broken  into  four  quadrants: 

UL:  Upp>er-Left 

UR:  Upper-Right 

LL:  Lower-Left 

LR;  Lower-Right 

There  are  four  predefined  depths  used  with  the  Ml?  application: 

8  Bits 
12  Bits 
16  Bits 

Overlay  Plane  (B 1 2-B 1 5) 

Predefined  abbreviations  are  used  for  these  area  and  use  the  nomenclature: 

GUL12  =  "Generalized  Area  of  Interest,  Upper  Left  quadrant, 

12  bits  deep"  would  have  the  coordinates  (0,0)  to  (512,512) 

GLROVL  =  "Generalized  Area  of  Interest,  Lower  Right  quadrant 

Overlay"  would  have  the  coordinates  (512,512)  to  (1024, 1024) 

This  nomenclature  is  used  throughout  the  MIPCTL  application. 
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4.3.3  Image  Memory  definitions  for  MIPCTL  applications 


Since  the  casual  user  in  the  field  does  not  need  to  be  concerned  about  the  above 
nomenclature,  a  number  of  image  areas  have  been  predefined  for  the  MIPCTl.  application, 
which  are  optimized  for  the  kinds  of  images  that  the  instrument  is  likely  to  be  taking. 
Understanding  this  predefined  structure  is  central  to  using  the  MIPCTL  application. 

Since  the  HAARP  and  MIP  imagers  have  a  512x512  CCD  digitized  to  12  bits,  we 
can  define  two  types  of  likely  images  to  be  collected  by  the  instrument.  At  full  resolution, 
we  have  512x512  pixels,  and  at  low -resolution’  we  use  a  2x2  binning  which  combines  4 
adjacent  pixels  into  one  'super-pixel'.  This  achieves  a  lower  resolution  of  256x256  pixels, 
and  quadruples  the  dynamic  range  of  the  CCD  (not  the  dynamic  range  of  the  AEXT 
converter  which  being  12  bits  is  always  4096:1). 

For  high  resolution  (Hi-Res)  images,  we  define  four  images  that  can  be  stored  into 
the  frame  buffer  memory.  As  in  Section  4.3.2,  we  define  these  four  images  as  UL,  UR,  LL. 
&  LR  ("Upper-Left,  Upper-Right,  Lower-Left,  and  Lower-Right").  Each  of  these  images 
are  512x512  pixels.  Ihere  are  four  images  in  the  Hi-Res  Quadrant  which  is  1024x1024 
pixels  wide.  Tliis  happ)ens  to  correspond  to  the  whole  frame  buffer.  Thus,  when  using  four 
Hi-Res  images,  there  is  no  room  for  any  more  images  on  the  AFG  board. 

For  low  resolution  (Lo-Res)  Images,  we  define  the  same  four  images  per 
Quadrant  each  with  the  dimensions  256x256  pixels.  Because  each  quadrant  now  has  a 
dimension  of  512x512  pixels  (note:  the  same  as  a  Hi-Res  Image),  there  can  be  four  Lo-Res 
quadrants  defined  in  the  AFG  frame  buffer.  These  four  Quadrants  are  defined  as: 

Data:  "Upper-Left"  usually  used  to  collect  raw  data  images 

Back:  "Upper-Right"  usually  used  to  collect  background  images 

Scratch;  "Lower-Left"  usually  used  for  calculation  images 

Display:  "Lower-Right"  usually  used  for  display  images 

In  each  of  these  quadrants,  there  are  the  four  Lo-Res  images  defined  above. 
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Within  each  of  these  images,  there  are  four  depths  that  can  be  defined: 

8  bits  12  Bits  16  Bits  OVL  (4  Bits:  Bl2  -  B15) 

These  depths  are  self-expanatory.  The  most  common  depths  used  in  MIPCTL  are  12  bits 
for  operations  on  12-bit  images  (e.g.  raw-data),  and  16  bits  for  operations  on  transformed 
data  (e.g.  stretched,  added,  etc. ). 

The  nomenclature  developed  for  MIPCTL  to  identi^'  these  different  images  is  as  follows: 
QQ:IIDD  where: 


(3Q  =  Quadrant: 

HR  =  Hi-Res 

DA  =  Data  (Lo-Res,  Upper-Left) 

BK  =  Back  (Lo-Res,  Upper-Right) 

SC  =  Scratch  (Lo-Res,  Lower-Left) 

DS  =  Display  (Lo-Res,  Lower-Right) 

n  =  Image 

UL  =  Upper-Left 

UR  ==  Upper-Right 

LL  =  Lower-Left 

LR  =  Lower-Right 

DD  =  Depth 

8  Bits  (BO  -  B7) 

12  Bits  (BO-Bll) 

16  Bits  (B0-B15) 

OVL:4Bits  (B12-B15) 

Thus,  using  this  nomenclature,  the  image: 

SC:LR12  corresponds  to: 

"Scratch  Quadrant:  Lower-Right  image,  12  Bits  deep" 
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Using  pixels  locations  in  the  frame  buffer,  this  would  be  an  image: 


Origin;  X  =  256,  Y  =  768  DX:  =  256  DY:  =  256 


This  image  is  represented  by  the  following  diagram: 


This  diagram  represents  the  MIPCTL  control  box  that  facilitates  selecting  an  image 
and  is  common  to  most  of  the  image  op>erations  in  the  MIPCTL  application.  The  four 
boxes  represent  the  images:  the  gray  box  representing  the  currently  selected  image.  Tlie 
button  at  the  bottom  of  the  box  has  text  in  it  that  represents  the  Quadrant  selected. 
Pressing  this  button  brings  up  another  box  that  allows  you  to  select  which  quandrant  you 
want: 


'Quadrant 

r Pixel  Depth  1 

OHI-Rcs:  Whole  Buff  1x1 

O  8  Bits 

<S>iData::  Upr  Left  2x2 

O  12  Bits 

O  Back  :  Upr  Right  2x2 

<S>  16  Bits 

O  Scrtch;  Lwf  Left  2x2 

O  Overlay 

O  Display:  Lwr  Right  2x2 

Any  changes  in  the  quadrant  is  reflected  by  the  text  in  the  button.  So  the  above  change 
would  be  reflected  with  the  text:  DATA:  16. 

4.3.4  Limitations  in  the  AFG  Frame  Buffer 

Because  of  the  physical  size  of  the  frame  buffer  (1024x1024x16),  there  are  only  so 
many  images  that  can  fit  into  the  frame  buffer  at  any  one  time.  It  should  be  understood 
that  physically,  the  Lo-Res  Quadrants  occupy  the  same  physical  space  as  the  Hi-Res 
Images.  Thus,  modifying  something  in  the  image  of  DA:UL16  is  also 
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modifying  ihe  data  of  HR:UL16.  Because  of  this,  the  user  has  to  be  careful  when  using 
data  of  different  resolutions. 

The  frame  buffer  can  hold: 

Four  Hi-Res  Images  1  Quadrant 

OR 

Sixteen  Lo-Res  Images  4  Quadrants 

An  example  of  mixing  resolutions  could  be  using  the  following  images: 

HR:UL16  HR:UR16  HR:LL16 

DS:UL16  DS:UR16  DS:LL16  DS:LR16 

4.4  AFG  Board  Hardware  Configuration  and  Juniper  Settings 


AFG-1K  Boird  Oltgrim 


Documtnl  Ch*ngt<  la  lh<  Dcftull  Coaft{untloo 


BOTTOM  I 
VIEW! 


IV 

JII 


Ir 


W-® 


VlSIONiuj 

Connedonl 


BUSO 


BUSl 


TOP 

VIEW 


AFG/ACO  Botrd  Dligrtm 


Figure  4.2  -  AFG  Board  Jumper  Settings 
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Chapter  5  Using  the  MIPCTL  Software 


5.1  Using  the  MIP  Image  Processing  System 

The  basic  functionality  of  the  Image  Processing  System  will  be  discussed  here. 
There  is  an  unlimited  range  of  possibilities  that  are  open  to  users,  depending  on  their 
understanding  of  all  the  components  of  the  system.  The  Windows  operadng  system, 
however,  is  designed  to  make  applications  self-explanatory  to  use.  With  a  limited  learning 
curve,  the  user  should  be  able  to  become  productive  with  the  MIPCTL  software.  The 
MIPCTL  software  tries  to  strictly  adhere  to  the  IBM  CUA  guidelines  so  that  all  key 
strokes  and  mouse  actions  are  consistent  with  the  Windows  Interface. 

If  users  becomes  limited  by  the  constraints  of  the  MIPCTL  application,  more 
flexibil’ty  can  be  gained  by  opening  Window's  Yerminal  program  to  talk  d’recily  to  the 
HAARP  imager  using  the  FORTH  commands  and  opening  Imaging  Technology's  Intrp 
interpreter  to  talk  directly  to  the  AI'G  board  using  Imaging  T. .  .inology's  ITEX  language. 
For  this,  the  user  should  refer  to  the  appropriate  manuals  fer  instruction. 

5.2  Using  Windows  3.1  and  MIPCTL 

5.2.1  Starting  Microsoft  Windows  3.1 

Upon  powering  on  the  computer,  it  will  go  through  it's  booting  procedure  until 
finally  ending  up  in  the  Windov^s  environment.  Many  windows  will  be  displayed  and  the 
Windows  Program  Manager  will  be  operating.  If  Windows  is  not  tunning,  ty'pe; 

win<cr> 


5.2.2  Starting  MIPCTL 

The  MIPCTL  control  Program  is  located  in  U  e  MIPCTL  Development  group  box 
and  under  it's  icon  the  name  MIPCTL  should  appear.  To  start  the  MIPCTL  program, 
double  click  (or  use  the  Windows  key  smokes)  on  the  icon.  An  "huur-gla.ss"  rcon  will 
appear  as  the  software  initializes  'tself.  There  are  rr.any  stages  of  initialization.  The  longest 
initialization  occurs  the  first  time  MIPCTL  is  started  after  the  computer  is  rebooted.  This 
is  due  to  the  AFG  board  being  loaded  up  with  all  of  it’s  board-resident  software.  If  the 


% 


computer  has  not  just  been  rebooted,  the  initialization  should  only  take  a  few  seconds. 
Once  the  initialization  has  been  completed,  the  "hour-glass"  icon  will  return  to  the  normal 
"arrow"  icon. 

The  initialization  of  the  MIPCTL  software  also  involves  setting  the  hardware  and 
software  parameters.  A  lot  of  these  arc  defined  in  a  file  called 


KEOCCD.INI  in  directory:  C:\W1ND0WS\ 


This  file  contains  camera,  communications,  and  software  semp  information  based  on  the 
last  execution  of  MIPCTL.  The  file  allows  the  software  to  automatically  come  up  in  the 
same  configuration  as  the  last  execution.  If  this  file  gets  corrupted,  the  initialization  may 
fail,  giving  an  appropriate  error  message.  In  this  case,  you  will  need  to  edit  KEOCCD.INI 
using  a  text  editor  such  as  Window's  NotePad,  and  manually  set  the  parameters  in 
KEOCCD.INI  to  valid  values.  Section  5.4  will  describe  KEOCCD.INI  in  more  detail. 

The  coinmunications  port  will  be  set  during  the  initialization  and  if  successful!,  a 
status  line  in  the  MIPCTL  Window  (usually  shrunk  so  that  you  can’t  see  it)  will  appear  that 
indicates  the  status  of  the  COMM  port.  Tne  HAARP  Imager  was  delivered  using  the 
following  COMM  Port  Settings: 


COM4, 9600  Baud,  8  Bits,  1  Stop  Bit,  No  Parity 


where  COM4  was  setup  (using  Window's  Control  Panel)  to  have  the  address  0x310, 
IRQl  1,  and  the  above  communications  settings.  If  there  are  any  problems  initializing  the 
port  (say  perhaps,  another  application  like  Terminal  is  using  COM4  or  KEOCCD.INI  has 
been  corrupted),  an  error  message  will  come  up.  You  should  exit  the  MIPCTL  program 
and  remedy  the  situation. 

Once  MIPCTL  has  successfully  opened  the  COM  port,  a  communications  status 
box  will  appear  in  the  Window: 
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y  '  '  '  MiP  Cailfiets  CoMrol 


Comm  £CO  Control  View  Analyze  Aguisiticn  ilelp 


These  numbers  do  not  directly  represent  the  communications  settings,  but  rather  the  Device 
Control  Block  Parameters  that  Windows  uses  in  setting  the  communications  port. 
However,  this  will  give  you  feedback  as  to  whetficr  the  port  is  set  up  the  way  you  want  it. 
Under  normal  circumstances,  you  can  ignore  this  status  window. 


During  the  initialization,  MIPCTJ^  tries  to  initialize  the  camera  to  it's  previous  state. 
If  there  is  a  problem  establishing  communication  with  the  camera,  the  following  warning 
box  will  appear.  This  warning  appears  at  any  time  during  the  application  if  there  is  a 
communication  problem  with  the  camera. 


If  this  error  occurs,  check  the  camera  communcation  system:  Is  the  cable  connected  to 
COM4?  Is  it  connected  to  the  camera?  Is  COM4  (or  whatever  port  you’re  using)  setup 
correctly  in  Windows  to  agree  with  the  installed  hardware?  Is  there  another  application 
open  that  is  using  the  COM  port  (such  as  TERMINAL)?  Power  down  the  camera  (or  push 
the  reset  button  on  it’s  rear  panel),  and  reboot  the  application. 

5.2.3  The  MIPCTL  Window'  and  Microiofi  Windows  3. 1 

The  MIPCTL  Window  is  a  standard  Windows  3.1  window,  and  thus  has  full 
Windows  3.1  functionality.  You  can  rc-size  it,  minimize  it,  move  it,  etc.  TTie  user  should 
become  familiar  with  the  use  of  Windows  31  to  gel  maximum  use  out  of  the  MIPCTI. 
application. 
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In  addition,  you  can  have  any  number  of  other  applications  running  at  the  same  time 
as  MIPCTL,  although  the  more  you  run,  the  slower  everything  will  be.  These  applications 
can  be  any  size  and  minimized  as  well.  After  starting  MIPCTL,  it  is  a  good  idea  to 
minimize  all  other  applications  (including  the  Program  Manager)  and  move  the  icons  over 
to  the  right  of  the  screen.  This  will  give  the  maximum  visibility  for  the  images  in  the  frame 
buffer. 

53  MIPCTL  Software  Manual  (v5.3.1) 


If  everything  was  successfully  initialized,  all  the  menu  elements  should  be  enabled 
and  appear  black.  If  they  are  grey  that  means  that  they  are  disabled.  The  main  menu 
should  read: 


MiPjtamera. Control 


The  underlined  letter  represents  the  Windows  keystroke  to  type  to  activate  this  menu  item. 
Type  the  <Alt>  key,  and  then  type  the  underlined  letter  if  you  do  not  wish  to  use  the 
mouse,  (see  Windows  3.1  User’s  Manual  for  more  information  on  Windows  keystrokes) 


5.3.1  The  Comm  Menu  functions 


The  Comm  menu  contains  the  initialization  functions.  It  looks  like: 


Initialize:  This  menu  item  initializes  the  COM  pon.  If  the  COM  port  is  already 

opened  to  the  application,  this  menu  item  will  be  disabled  and  appear  grey.  There  may  be 
times  when  you  would  want  to  reinitialize  your  COM  port.  For  example,  you  want  to  talk 
to  the  HAARP  irnager  via  a  communications  program  such  as  TERMINAL  to  test  some 
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functionality  without  closing  MIPCTL  and  thus  loosing  all  the  infonnadon  presently  in  the 
frame  buffer  and  MIPCTL  buffers.  You  would  Qose  the  COM  pon,  and  when  ready  re¬ 
initialize  using  Initialize.  Notice  that  when  you  close  the  COM  port,  all  menu  items  tliat 
rely  on  communications  with  the  camera  turn  grey  and  arc  Disabled. 


Settings:  Settings  allows  you  to  change  the  communications  settings  on  the  COM 

port.  This  is  normally  not  desired,  but  there  could  arise  times  when  you  want  to  use  a 
different  COM  port,  slower  baud  rate  or  the  like.  Also,  this  allows  for  future  situations 
when  the  camera  hardware  might  be  slightly  different  Once  the  settings  have  been 
changed,  the  port  should  be  Closed  and  re  -Initialized. 


Baud  Rate 

Olio  O  300  Oeoo  O1200 
O2400  O  4800  <g>  9600  O  19200 


'Data  Bits 

'Stop  Bits 

Os  0  6  0  7  <S>  8 

1  0  1 .5  0  2 

1_ 


r  Parity - 

OOdd 

0  Even 

0  Mark 

0  Space 

rComm  Port - 

O  COM1  O  COM2 
O  COM3  <^COM4 


Close:  Tliis  closes  the  COM  port  and  disables  all  the  menu  items  that  need  communication 
to  the  cainera.  This  is  described  in  more  detail  in  Initialize. 
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5,3.2  The  CCD  Menu  functions 


The  CCD  menu  has  the  functions  that  control  the  CCD  camera.  It  looks  like: 


Bias:  A  bias  is  executed  on  th  ainera  and  read  into  the  frame  buffer  at  the 

presently  selected  image  (sec  Display).  A  Bias  is  used  to  check  the  read  amplifier  gain  of 
the  CCD  read  electronics.  The  CCD  is  cleared  three  times  to  make  sure  there  is  absolutely 
no  residual  charge  or  dark  noise  in  the  CCD  wells,  and  the  CCD  is  subsequently  read  out 

Read:  The  CCD  is  read  out  into  the  presently  selected  image  of  the  frame  buffer.  A  Read 
contains  whatever  was  in  the  CCD  at  the  time  of  the  read.  If  the  CCD  had  been  sitting  for 
20  minutes  there  would  20  minutes  of  dark  noise  and  light  leaks  accumulating. 

Clear:  Clear  clears  out  all  the  CCD  pixels  without  reading  them. 

Default:  Default  sets  the  CCD  read  parameters  to  the  default  conditions.  For  a  detailed 
description  of  these  parameters  see  the  FORTH  documentation.  A  default  read  has  1x1 
binning,  and  all  512x512  pixels  are  captured  by  the  AFG  board. 


Obs/Dark:  Observe  gets  its  name  from  the  astronomy  community  and  is  used  to  be 
consistent  with  Photometries  and  Advanced  Technologies  terminology.  Obs/Dark  pops 
up  a  dialog  box,  that  lets  you  select  the  destination  location,  the  exposure  time,  and 
whetiier  to  take  an  exposure  or  a  dark  exposure. 
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Obsijrvc/Diirlr 


Exposure  Time: 

(1/1 0th  sec) 


10 


'Exp.  Mode~ 
O  Dork 
^{Observe! 


m 


S  Display  Image  Information 


iimm  imri 


This  dialog  box  stays  active  throughout  the  exposure  until  you  exit  it.  This  is  convenient 
for  taking  many  different  exposures  during  a  test.  The  dialog  box  can  be  moved  wherever 
you  want  (even  almost  all  the  way  off  the  screen)  so  that  the  image  being  captured  is  fully 
visiWe. 


The  Display  Image  Information  check  box  indicates  whether  MIPCTL  should 
store  a  'snap-shot'  of  the  camera's  status  at  the  time  of  exposure,  store  this  in  the  image 
information  buffer  associated  with  this  image,  and  label  the  image  overlay  with  the 
information  titles.  The  information  parameters  are  things  like  dme,  exposure,  filter  value, 
tempcratiu'es,  location,  etc.  and  are  discussed  in  more  detail  in  Section  6.2.  Image 
information  is  usually  important  if  you  want  to  archive  this  image  and  use  it  for  later 
analysis.  If  the  image  is  used  purely  for  temporary  infonnation,  such  as  focusing  the  image, 
then  it  is  quicker  to  not  display  (and  store)  this  information. 


Shade:  Shade  produces  a  horizontal  wedge  pattern  with  every  64th  pixel  increasing  in 
intensity  by  a  value  of  1.  Thus  each  row  will  increase  in  intensity  by  8,  and  a  512  row 
image  will  test  out  all  of  the  pixel  intensities  from  0  to  4095.  This  is  useful  to  test  out 
whether  the  camera  is  working,  whether  the  digital  input  port  is  working,  or  even  a  quick 
way  to  test  the  communications  intcifacc. 
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Setup:  Setup  pops  up  a  dialog  box  that  lets  you  set  details  of  the  CCD  read  out. 


CCD  Settings... 


'Binning — 
<S>  1x1 
02x2 

CCO  Gain  for  HRP — 

^iLow:  91e-/A0Ui 
Read  Noise:  63e- 

O  Mid:  49e-/AOU 
Read  Noise:  39e- 

PS5SI 

I^J 

O  High:  25e-/AOU 
Read  Noise:  24e- 

The  CCD  camera's  Gain  can  be  set.  The  gain  is  defined  as  how  many  electrons  it  takes  to 
equal  one  ADU  (Analog  Digital  Unit).  The  read  noise  associated  with  this  gain  is 
displayed  for  your  reference.  These  values  arc  displayed  automaticaliy  depending  on  which 
camera  head  has  been  selected  in  the  KEOCCD.INI  file.  If  the  heading  displays  a  different 
camera  head,  you  should  correct  this  by  editing  KEOCCD.INI  with  a  text  editor.  The  two 
camera  heads  currently  supported  (v5.3.2)  arc  MIP  and  HRP  (HAARP). 

The  user  can  also  select  the  binning  factor  from  this  dialog  box.  Currently,  only 
two  standard  binning  functions  arc  allowed:  1x1  &  2x2  which  correspond  to  the 
Hi.Resoludon  and  Lo_Rcsolution  images  discussed  in  Section  4.3.3.  An  inactive  button 
Advanced  is  in  the  dialog  box  for  the  future  addition  to  the  software  to  allow  the  user  to 
manually  set  all  the  individual  parameters  of  the  CCD  readout.  Tnis  will  allow  features 
such  as  flexible  XY  binning  &  sub-sample  readout 

5.3.3  The  Control  Menu  funcuons 

The  Control  menu  has  the  functions  that  control  the  HAARP  imager  control  electronics. 
It  looks  like; 
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Control:  This  menu  item  allows  the  user  to  control  the  filter  wheel  and  the  intensificr. 

The  dialog  box  emulates  the  control  panel  on  the  HAARP  imager  and  is  used  in  much  the 
same  way.  The  target  and  present  values  are  displayed  in  two  large  "LEDs".  The  user 
selects  a  new  target  for  cither  the  intensificr  or  fiitcrwhcel,  selects  the  Intensificr  Power  On 
or  Off  Bunon,  and  when  ready  Sets  this  new  state.  If  Set  is  not  pushed,  this  new  state  will 
not  be  updated  to  the  camera  and  changes  will  not  be  reflected  in  the  Preset  T-EDs’. 


Mip  Controls 


rRlter  Wheel  Control' 


I 


O  Po8.  Err 


Present  Target 


["Image  Intensificr  Control 

~  Power" 
O  On 
^0« 

Present  Target 


Shutters:  The  shutters  can  be  manually  opened  and  closed  with  this  menu  item.  There 

arc  status  LED's  in  this  dialog  that  mimic  the  same  function  on  the  HAARP  imager  control 
panel  indicating  whether  the  shutters  arc  physically  open  or  not.  These  status  lights 
represent  the  state  of  physical  microswitches  inside  the  shutters  of  the  camera.  This  feature 
is  often  used  to  check  the  shutters  for  correct  operation,  or  for  doing  specialized  work  with 
the  camera  (e.g.  for  visual  inspection  of  the  image  intesificr:  remove  the  head,  open  the 
back  shutter,  check  the  <'ght  conditions  and  open  the  front  shutter.  ) 
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MIP  Shutlcfc 


Temperature:  This  menu  item  reads  aU  the  system  temperatures,  and  displays  them 

in  degrees  Celsius.  It  also  reads  the  Intensifier  Brightness  PhotoDiode.  An  example  of 
using  this  and  the  Shutter  dialog,  would  be  to  open  Shutter  1,  do  a  Temperature,  check 
the  Intensifier  Brighmess  value  to  see  how  bright  the  intensifier  is  and  then  close  Shuner  1. 


With  the  current  software  version  (v5.3.2),  this  dialog  box  will  do  a  read  every  2  seconds 
and  automatically  update  the  LED'  displays.  While  reading  the  camera,  the  camera  icon 
will  come  on.  Unfortunately,  everything  is  locked  up  dunng  this  period,  so  hitting  the  'OK' 
button  with  this  icon,  will  not  terminate  the  dialog  box.  The  user  must  wait  until  the  icon 
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has  returned  to  the  ’ARROW’,  and  then  click  on  the  OK  button  or  hit  a  <cr>.  This  will  be 
improved  in  a  later  software  release. 

5.3.4  The  View  Menu  functions 


The  View  menu  controls  the  basic  image  processing  functions.  It  looks  like: 


ifldeo... 

LUT... 

Cursor... 

ytilHics 


Display:  The  Display  dialog  lets  the  user  select  wliich  image  or  quadrant  to  display. 

Refer  to  Section  4.3.3  to  get  a  full  image  and  quadrant  nomenclature  explanation.  The  user 
has  the  option  of  looking  at  an  image  individually  or,  looking  at  a  whole  quadrant 


■JuftJy 
<i>  Top 

O  Cenlei 
O  BoUom 


Quadfonl 

Justdy 

O  Hi-Re»;  Whole  buffer 

Top 

O  Dale:  Upper  Left 

O  Cerrter 

O  Backgnd:  Upper  Right 

O  Bottoin 

®  ^Scratch:  Lower  Leffi 

O  Display:  Lower  Right 

i^— M 

106 


Image  or  Quandrant  displays  have  three  justifications:  Because  the  images  have  a 
integral  height  of  512  pixels,  and  the  VGA  screen  has  a  height  of  480  pixels,  a  whole  image 
(or  quandrant)  cannot  be  viewed  on  a  VGA  display  (640x480).  The  user  could  change  the 
resolution  of  the  display  to  SVGA  (800x600),  but  then  the  screen  would  have  to  be 
recalibrated  and  the  images  would  be  significantly  smaller.  It  was  decided  that  the  VGA 
display  would  be  a  better  choice,  giving  larger  images. 

In  order  to  cover  the  whole  image,  the  user  selects  which  justification  to  view  the 
image:  Top,  Center,  and  Bottom.  Top  allows  the  viewer  to  see  the  top  of  the  image, 
cutting  of  the  bottom  32  lines.  Center  'centers’  the  image  vertically,  cutting  off  the  top  and 
bottom  16  lines.  Bottom  displays  the  bottom  of  the  image  cutting  of  the  top  32  lines.  The 
default  display  mode  is  Center. 

A  display  characteristic  of  the  AFG  board  should  be  mentioned  here.  When 
displaying  the  Hi_Resolution  Quadrant,  the  AFG  board  is  squeezing  a  1024x1024  image 
area  into  a  512x480  VGA  window.  To  do  this,  the  AFG  board  drops  every  other  pixel. 
This  can  result  in  erroneous  looking  graphics  and  image  artifacts  that  are  not  inherent  in  the 
image. 

Video:  This  dialog  box  allows  you  to  change  some  of  the  video  features  associated  with 
the  image  display.  Since  the  VGA  display  is  mixed  with  the  AFG  image  display,  there  are 
several  options  that  can  be  used.  The  default  values:  VGA  Mixing  Mode:  VGA  Base  and 
Key  Color;  Blue. 


“VGA  Mixing  Mode" 

"  Key  Color 

O  VGA  Only 

<S>  Blue 

^GABaiel 

O  Green 

O  IMG  Bate 

O  Red 

O  IMG  Only 

_ 

OK  1 

There  are  four  VGA  mixing  modes:  VGA  only  gives  you  just  the  VGA  display. 
TOs  could  be  useful  if  you  wanted  to  work  just  in  the  Windows  environment  for  a  while 
(say  you  were  developing  some  new  C  source  code  to  fix  software  bugs!).  The  MIPCTL 
program  would  still  be  running,  but  you  would  not  see  any  of  the  frame  buffer.  VGA  Base 
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is  the  default  mixing  option.  This  sets  the  VGA  as  the  base  and  anything  in  the  VGA 
display  that  matches  the  selected  key  color  becomes  transparent  Gike  the  blue  windows 
created  by  MIPCTL  to  give  a  'port'  through  to  the  images  in  the  AFG  frame  buffer).  IMG 
Base  is  the  opposite.  The  image  is  the  base  and  anything  that  is  blue  in  tlie  image  will  be 
transparent  and  show  the  VGA  display.  This  is  not  a  very  practical  option  but  is  included 
more  for  the  sake  of  completeness.  Hnally,  the  IMG  Only  option  displays  only  the  firame 
buffer  display  and  could  be  useful  in  some  cases.  This  is  terminated  by  clicking  the  mouse 
or  by  hitting  a  key.  Note  that  the  display  will  wrap  around  when  you  do  this  as  the  pbcels 
in  a  row  over  J12  will  continue  into  the  next  pixel  of  the  VGA  display  and  so  forth. 


LUT:  The  LUT  menu  item  allows  the  user  to  set  LUT s  on  the  AFG  Board.  LUT 

stands  for  Look  Up  Table  and  represents  how  a  12  bit  pbtel  value  will  be  converted  upon 
passing  through  the  LUT.  The  standard  uses  for  an  LUT  are  for  the  display  (as  in  the  first 
3  LUT's),  or  for  transforming  an  image  on  a  pixel-by-pixel  basis  (such  as  Stretch:  mapping 
all  pixels  in  an  image  with  values  of  say,  1(KX)  -  3000,  to  an  image  with  values  0  -  4095). 


rPrcdefined  LUT's 


<S>[[^BirUnc8r: 

O  8  Bit  Preset 
O  12  Bit  PsucdoColor 


StretdiLUT’ 


iOiC 


For  a  detailed  description  of  this  it  is  recommeni. .  i  that  you  read  the 
Hardware/Software  Introductions  for  the  AFG  board  as  well  .  ^  Chapter  6  of  the  ITEX 
Software  Manual.  In  addition,  if  more  complicated  LUT  operations  are  needed,  they  can 
be  implemented  using  the  ITEX  LUT  commands  through  tl  interpreter  program  of  the 
AFG  (INTRP). 
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Input  to  OUTPUT  LUT 


Figure  5.1  -  12  Bit  Linear  Grey-Scale  Ouptu:  LUT 


n  gitPSW^ftlOr  LUT 


Input  to  OUTPUT  LUT 


Figure  5.2  -  12  Bit  Psuedo-Color  Output  LUT 

You  can  just  click  on  the  preset  LUTs  given  to  you  in  this  menu  item  to  see  how 
different  LUTs  affect  the  image.  The  first  three  LUTs  affect  the  way  the  whole  frame 
buffer  is  displayed  (the  OUTPUT  LUT).  There  are  three  default  LUTs  defined  in  the 
HA  ARP  system:  12  bit  Linear,  8  bit  Default,  and  12  bit  Psuedo  Color.  Refer  to  the  ITEX 
Software  manual  to  get  a  description  of  the  8-bit  default  OUTPUT  LUT  definitions. 
Figure  5.1  shows  a  12-bit  Linear  gray-scale  LUT,  and  Figure  5.2  shows  a  12-bit  psuedo- 
color  LUT.  The  final  LUT  affects  the  INPUT  LUT,  or  the  LUT  that  transforms  incoming 
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pixels  into  the  frame  buffer.  This  is  used  to  rescale  an  image.  Tc  do  this,  you  press  the 
STRETCH  LUT  button,  and  a  new  dialog  appears  which  allows  you  to  select  the  source 
and  destination  locations  fthey  can  be  the  .same,  i.e.  if  you  have  already  saved  your  data),  to 
enter  manually  the  mininium  and  maximum  values  for  the  LUT,  or  to  use  the  grapliical 
display  to  set  the  LUTs  by  moving  the  Min.  and  Max.  arrows. 


Once  you  have  the  desired  values,  press  SET  and  MtPCTL  will  "Snap"  the  source  image 
into  the  destination  image  (passing  it  through  the  INPU  T  LUT). 

Cursor:  This  menu  item  pops  up  a  display  box  and  changes  the  l  ursor  to  a  cross-hair. 
The  display  box  gives  the  x,y  Ixation  of  the  pixel  in  the  frame  buffer's  coordinates,  and 
gives  the  intensity  of  the  pixel  at  that  point.  To  end  the  cursor  routine,  click  the  mouse 


Utilities: 


The  Utilities  sul>inenu  lcx)ks  like; 


Clear  Image:  This  is  a  utility  to  clear  different  areas  of  the  frame  buffer.  You  can 
determine  what  the  final  pixel  value  of  this  area  will  be  by  changing  the  value  in  the  edit 
box. 


rArea 

O  Whole  AFG 


<$>  Selected  GAOl 
O  Selected  ROI 


Clear  to;  g 


Depth 

O  i) 

<S>  fJil;) 

O  1  f;  Ui1;> 

O  Oviirkiy 


Citftcel  I 


mi 


The  value  will  be  clipped  to  whatever  destination  pixel  depth  you  have  selected.  You  can 
select  areas:  The  whole  frame  buffer,  a  particular  image,  or  the  presently  defined  Region- 
of-lnteresi  for  that  image.  There  are  four  depths;  8  Bits,  12  Bits,  16  Bits,  and  the  Overlay 
which  is  the  most  significant  4  bits  of  the  frame  buffer. 

An  example  of  using  this  utility  would  be  when  you  wanted  to  do  some  16  bit 
arithmetic  on  a  12  bit  image  that  had  some  graphics  data  in  it.  Before  doing  the  arithmebc, 
you  should  clear  the  bits  for  that  region  to  0,  so  that  the  graphics  pixel  values  do  not  affect 
the  math.  Of  course,  this  would  destroy  the  graphics  in  the  image. 


HI 


Another  example  of  using  this  utility,  would  be  if  you  wanted  to  do  some  image 
arithmetic  using  a  constant  operand  (the  current  software  version  (v5.3.2)  docs  not  support 
constant  operand  arithmetic).  Clear  a  destination  image  to  the  value  desired  for  the 
constant  operand  (say  100)  and  then  use  this  as  the  destination  image  of  your  image 
arithmetic  (discussed  in  Section  5.3.5).  If  you  were  doing  addition,  your  math  would 
become: 


Clear  Source  1  Image  to  100 

Dest  Image  =  Source2  Image  +  Sourcel  Image  (D  =  S2  -i-  100) 

Clear  Overlay;  The  overlay  window  is  a  VGA  window  that  overlays  the  AFG  frame 
buffer  image  and  is  used  to  draw  graphics  and  text.  This  insures  that  none  of  these 
graphics  objects  corrupt  the  16  bits  of  the  data  stored  in  the  frame  buffer.  Use  this  utility 
to  clear  tliese  overlay  objects; 


Snap:  This  utility  lets  you  snap  one  image  to  another  image.  This  is  done  by  selecting  the 
source  ajid  destination  quadrants  and  then  hitting  OK  (or  hitting  a  <cr>).  This  is  useful  for 
duplicating  images  in  the  frame  buffer  for  subsequent  manipulation  and  comparison. 


The  snap  dialog  box  has  provision  for  setting  the  Min/Max  of  the  Input  LUT.  This 
converts  the  destination  image  in  exactly  the  way  that  Stretch  does  (discussed  above  under 
LUT's). 
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Label  Image:  The  dialog  box  allows  the  user  to  'stamp'  the  text  fields  associated  with  the 
image  information  from  the  Overlay  Window  directly  into  the  image  pixels.  The  text  will 
be  written  into  the  OVL  bits  of  the  frame  buffer  (B12-B15)  and  so  will  not  corrupt  12  bit 
data. 


Stamp  Ovcrtay  to  Image ' 


Location:  [kEO  Lab 


Comnenl:  CCD  Flat  Fitrfd  tGl 


Dettination  lokage: 


Date:  16Jul93 

Time: 

14:45:04 

Eep.  Time: 

2  2 

Int.  Gain; 

|o 

Filiei:  None 

The  user  can  select  the  destination  image.  If  the  image  has  an  image  information  buffer 
defined  already,  this  uiformation  will  be  filled  into  the  appropriate  edit  fields  of  the  dialog 
box.  The  user  can  then  modify  these  values  to  reflect  the  final  text  they  want  to  be 
stamped  into  the  image.  The  Stamp'  b  ition  can  then  be  hit  and  the  user  will  notice  the  text 
being  transferred  directly  into  the  image. 

This  featuie  is  useful,  for  example,  if  the  image  is  to  be  distributed  to  another 
scientist  who  does  not  want  to  spend  time  deciphering  JvIIPClX's  image  header.  The  text 
imprinted  into  the  image  data  will  readily  identify  the  image  and  work  on  any  image 
processing  system  that  can  read  16  bit  images. 
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5.3.5  The  Analyze  Menu  functions 


The  Analyze  menu  controls  the  basic  image  processing  functions.  It  looks  like; 


Select  ROI:  Select  ROI  (Region-of-Interest)  lets  you  select  a  ROI  either  by  using  the 
mouse  or  by  entering  the  coordinates  of  the  ROI  from  the  keyboard. 


Select  ROI 


~ROI  Coordinates 

XI : 


126 


VI  154 


A  colored  rectangle  will  appear  in  the  overlay  window  where  the  ROI  is  defined.  You  can 
also  delete  the  defined  ROI  with  this  menu  item.  With  the  current  software  (v5.3.2),  each 
image  can  have  one  ROI  presently  defined.  If  the  ROI  is  already  defined,  it's  coordinates 
will  appear  in  the  edit  fields  when  the  image  is  selected. 

Once  the  ROI  is  defined,  it  stays  in  memory  until  you  delete  it  by  hitting  the  'Delete' 
button  in  the  Select  ROI  dialog  box.  Any  subsequent  call  that  uses  a  ROI,  will  use  this 
defined  ROI,  If  no  ROI  is  defined,  a  warning  will  appear,  and  you  should  execute  this 
dialog  box  to  define  one. 

To  use  the  mouse,  click  on  the  mouse  button  and  move  the  mouse  to  your  desired 
starting  fiosition.  Notice  that  the  origin  coordinates  will  be  updated  with  the  mouse 
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movements.  Once  you  arc  at  your  desired  origin,  depress  the  mouse  button,  and  while 
holding  it  down,  drag  the  mouse  to  you  ending  point.  A  colored  rectangle  will  follow  the 
movement  of  the  mouse.  If  you  are  dissatisfied  with  the  result,  either  type  in  a  new  ROI, 
or  just  press  the  MOUSE  button  again  and  a  new  ROI  will  be  defined. 

SXatistics;  Statistics  calculates  the  Mean,  RMS.  Max,  and  Min  of  the  presendy  defined 
ROI  in  the  selected  image. 


Min:  824 
Max:  1941 

rROI: 

XI:  164 

Y1 : 1 82 


Statistics 


Mean:  1339.18 
RMS:  118.294 


X2:  317 
Y2:  338 


The  Statistics  dialog  box  also  gives  you  the  coordinates  of  the  ROI  and  die  number  of 
pixels  (data  points)  contained  in  the  ROI.  In  addition,  you  can  select  a  new  image  from 
within  the  Sutistics  dialog  and  new  statistics  will  be  calculated  for  the  defined  ROI  of  this 
image. 


Uistogram:  Histogram  computes  a  histogram  of  the  selected  image  (or  ROI  defined 

in  the  image)  and  plots  the  results  in  the  standard  MIPCTL  plotting  window. 


Histogram 


fGaoi: 


O  ROI 


Step: 

B.n:  □ 
Q  AutoBin 


There  are  two  parameters  that  control  the  histogram  that  ca.n  be  changed.  Step  size,  and 
Bin  size.  Step  size  refers  to  how  many  pixels  are  taken  for  the  sample.  1  corresponds  to 
every  pixel,  and  n  corresponds  to  every  nth  pixel.  The  higher  the  step  size,  the  quicker  the 
histogram  will  execute,  but  the  less  representative  of  the  image  the  results  will  be. 
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Bin  Size  refers  to  how  many  histogram  bins  arc  computed.  1  corresponds  to  every 
pixel  value  (0  to  4095  for  a  12  bit  image),  2  corresponds  to  2  pixel  values  binned  into  one 
bin  (0  to  2047  for  a  12  bit  image),  etc.  This  will  also  greatly  increase  the  speed  of 
histogram  execution. 

The  AutoBin  checkbox  allows  the  MIPCTL  application  to  determine  the  optimum 
bin  size  for  a  plot.  Sin^e  most  Histograms  are  used  for  plots,  a  value  similiar  to  the 
resolution  of  the  VGA  screen  would  be  best.  Since  the  maximum  horizontal  resolution  of 
our  monitOTS  is  1024  pixels,  a  normal  histogram  would  be  1024  points.  The  AutoBin 
calculates  this  binning  factor:  For  the  16  bit  image  selected  above,  a  burning  factor  of  6  is 
used  to  map  0  -->  65535  to  0  ->  1023  (65536/1024  =  64  or  2'''*6). 

If  higher  resolution  data  for  the  histogram  is  desired,  then  disable  the  AutoBin 
mode  by  clearing  the  checkbox,  and  enter  the  desired  binning  factor. 


Eow  and  Column  Plot:  Row  and  Column  plot  read  a  line  of  pixels  down  a  selected 

column  or  row  and  then  plots  this  in  the  standard  Plot  window.  You  can  either  enter  the 
column  or  row  manually  via  an  edit  box,  or  by  using  the  mouse.  A  colored  line  unique  to 
this  plotting  window  appears  in  the  overlay  window  for  the  image. 


Arbitrary  Plot:  Arbitrary  plot  reads  a  line  of  pixels  across  an  arbitrary  line  and  then 

plots  this  in  the  standard  Plot  window.  You  can  either  enter  the  line  manually  via  edit 
boxes,  or  by  using  the  mouse.  A  colored  line  unique  to  this  plotting  windov/  appear.s  in  the 
overlay  window  for  the  image.  The  AFG  board  reads  the  pixel  values  along  an 
approximation  of  this  line.  The  number  of  points  read  correspiond  to  the  x  distance  of  this 
line,  not  V(x‘  +  y^)  as  one  might  expect. 
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Hot  Afliitrary  I  ii»e- 


Open  Plot:  This  tnenu  command  allows  the  user  to  open  up  a  previously  saved  plot  £mm 
the  MIPCTL  application.  This  plot  must  be  stored  in  the  format  discussed  below  as 
defined  by  the  MIPCTL  application.  A  user  could  in^xwt  data  from  another  application 
and  manually  create  the  necessary  header  with  a  standard  text  editor  if  needed.  Once  this 
plot  is  opened,  it  is  treated  just  like  any  of  the  other  plot  windows  created  with  the  above 
commands. 


Image  Arithmetic  from  the  Analyze  menu: 


The  image  math  menus  pop  up  a  dialog  box  that  lets  you  select  all  the  necessary  features  to 
perform  the  image  arithmetic.  Each  menu  item  will  bring  tliis  dialog  up  in  the  default  form 
for  it's  operation,  but  you  can  change  any  of  the  displayed  parameters.  TTie  source  and 
destination  GAOl's,  the  depth,  and  the  post-processing  flag  are  selected. 
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Sourcel 


Post-Processing'  '  ' 

m 

n 

O  Unsigned  O  Positive  O  Absolute 

OH: 

Source2 


Destiritation 


Math  Op. 
0*0/ 


For  a  detailed  description  of  how  the  AFG  docs  math,  refer  to  the  ITEX  Software  manual 
(CH.  1 1)  and  the  ITEX  Release  Notes  v2.2-2.  but  briefly  the  math  equations  are  as  follows: 


Add: 

Subtract: 

Multiply; 

^Divide: 


DEST=  PF1.AG(S0URCE1  S0URCE2) 

DEST  =  Pn.AG(SOURCEl  -  S0UCE2) 

DEST  =  PEL  AG  (  ( (SOURCE!  •  S0URCE2)  »  SCALE  ]-*-OFFSET  ) 
DtSl  =  PPL  AG  1  1  (SOURCE!  /  S0URCE2)  »  SCALE  )+OFFSET  ) 


where; 


PFLAG  is  the  post  processing  flag  and  can  have  the  values: 

ABSOLUTE;  Negative  values  are  convened  to  positive  values 


NONE  : 
POSITIVE  : 

NEGA~i  IVE; 

SIGNED: 


and  positive  values  are  left  unchanged. 

No  Post-Processing. 

Positive  values  are  clipped  to  the  maximum  GAOI 
depth  and  the  negative  values  arc  set  tc  zero. 
Negative  values  are  made  posiuvc  and  clipped  to  255. 

Positive  values  are  sci  to  0. 

.Numbers  are  treated  as  signed  values. 


SCALE  is  used  in  multiply  and  divide  to  shift  the  result  of  the  mult./div. 
cither  left  or  right. 

OFFSET  IS  a  constant  number  added  to  the  mult./div.  operation  after  the 
shift  but  before  the  post  processing. 


♦Fur  riEX  v2.2-2,  the  Divide  function  was  disabled  on  the  AFG  board 
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User’s  Note:  When  looking  at  data  where  diftoences  are  of  interest,  such  as  calculating 
the  meanA'ariance  curves,  negative  numbers  are  significant  Since  the  math  on  the  AFG 
board  is  done  in  signed  arithmetic,  you  will  need  to  clear  all  16  bits  of  any  extraneous 
information  (such  as  overlays!),  arxl  then  do  signed  arithmetic.  Even  if  the  images  are  only 
12  bits  deep,  all  16  bits  will  be  used  in  the  result  because  of  the  way  signed  integers  are 
represented  on  the  AFG  board. 

It  would  be  a  useful  exercise  for  users  to  experirrient  with  these  features  with  different 
post-processing  options  and  GAOI  depths  to  make  sure  they  understand  the  hardware 
processing  on  the  AFG  board.  The  image  math  is  extremely  fast  on  this  board  (<16msec), 
but  capabilities  are  limited  by  the  hardware  architecture. 

Save  Saves  the  image  selected  in  the  Source  GAOI  control  to  disk.  The  image  is 

stored  in  the  ITEX  format.  The  image  can  be  stored  on  any  disk,  in  any  directory  and 
follows  the  standard  IBM  CUA  guidelines  for  File  Saving. 


newimg  Mg 


Pile  Naate: 

Oifcctoiy:  c:\MpVcaltb(a( 

I2.Keclo(iet: 


11 

I«1 

(bl 

(cl 

1«»-I 

l«l 


1 01^^ 


‘>Canc^  i 


rSoMce  Gaoi: 


Kestore  Data:  Restore  Data  allow.s  the  user  to  open  up  an  image  from  die  disk 

using  the  standard  IBM  CUA  guidelines  for  opening  files.  This  image  is  assumed  to  be  in 
ITEX  format,  and  will  be  read  into  die  currently  displayed  GAOI. 
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Open  image  File 


Fie  Naate:  |biashigKi«g 
Daectofy: 

Eile»: 


c:\iMp\caliMai 


m 


1 

1 1 

1^ 

lal 

I-b-l 

1  butfow.iag 

1^1 

1  biatmidixig 

N-1 

I-«-l 

|c:cdiexl1.iaig 

IlNJ. 

Ins 

iNJ.'MIlcI 

s 

rOesUnelion  GAOl 


Image  Info:  This  dialog  box  allows  you  to  quickly  look  at  the  image  information  header 
of  any  image  on  the  disk.  This  box  does  not  initially  restore  the  whole  image  to  a  GAOL 
If  you  want  to  view  this  image,  you  can  then  select  the  RESTORE  button  and  the  image 
will  be  restored  into  the  selected  GAOL 


€W^CAUBRA1^iASLQVyd^^ 


image  Deated:  13  Jut  33  08:48:18 
Filtet:  noneA  Vettion:  5.2 


Exp.  Time:  2.0  tec  Ini.  Gain:  0  Bit:  -10 
FOV:  0  Cameta:  HRP 

Caneta  Gain:  0  Binning:  1x1 


j  CCO  Temp: 

29  5C 

TEC  TexH>: 

42. 5C 

j  Ini.  Temp: 

55. 5C 

Fill.  Texip: 

52.ee 

Locetfon:  kEO  Lab 

CooMienl:  Bias:  Lot*  Gain 


If  the  image  is  not  an  Image  Technology  image  file,  this  function  will  not  work  and  an  error 
dialog  will  appear.  The  first  two  bytes  of  an  ITI  image  file  have  the  characters  IM'  to 
identify  it  as  an  image  file.  Refer  to  Section  6.1  for  a  full  explanation  of  the  image  file 
format. 

The  image  information  header  is  looked  at  next  to  check  that  the  header  was  written  by  the 
KEO  Consuiianis  software  package  and  which  software  version  was  used  to  look  at  this 
header.  If  there  is  a  discrepancy  between  software  versions,  or  the  header  was  not  written 


120 


by  MIPCTL,  the  header  is  written  into  the  Comment:  field  of  the  dialog  box  so  the  user 
can  examine  it.  Refer  to  Section  6.2  for  documentation  on  the  KEO  Image  Information 
Header. 

5.3.6  MIPCTL  Plotting  Windows 

MIPCTL's  Plotting  Windows:  The  MIPCTL  has  a  standardized  plotting  window 
feature  that  allows  multiple  plots  of  different  types  to  be  created  and  displayed  These  plot 
windows  are  standard  Windows  3.1  windows  and  thus  can  be  minimized,  scaled,  moved 
and  resized.  A  plot  window  has  a  plot  structure  associated  with  it  that  stores  the  necessary 
plot  inforraarion  such  as  plot  type  (Histogram,  Row,  Col,  Arbitrary  Line),  the  pixel 
locations  for  the  plot  endpoints  (if  a  Unc  plot),  or  the  StepSize  and  BinSize  (if  the  plot  is  a 
Histogram),  the  image  in  the  frame  buffer  that  the  plot  was  taken  from,  and  pointers  to  the 
actual  plot  data  and  the  plot  window  displaying  the  data. 

Many  plot  windows  can  be  open  at  the  same  time.  The  handling  of  these  plotting  windows 
is  done  by  a  Graphics  Server  that  responds  both  to  user  commands  and  messages  fiom  the 
MIPCTL  application.  While  any  plot  window  is  open,  the  Graphics  Server  wdl  also  be 
open  and  will  appear  as  an  icon  in  the  Window’s  background.  Do  not  close  the  Graphics 
Server  while  MIPCTL  is  still  running  as  it  will  affect  the  plots  currently  displayed  by 
MIPCTL.  MIPCTL  will  open  and  close  the  Graphics  Server  as  needed. 


The  above  plot  window  shows  a  plot  taken  from  an  Arbitrary  plot  line.  The  title  of  the 
plot  window,  ”P#0:  ARB  Plot  From  Gaoi:  HR:IJL16"  tells  you  which  plot  window  number 
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(0),  the  kind  of  plot  (ARB),  and  the  image  in  the  frame  buffer  that  the  plot  was  taken  from 
(HR:UL16). 


The  title  of  the  plot:  "ARB  Plot:  31  Dec  69  16:00:00  4278A"  indentifies  the  image 

information  of  the  plot:  Type,  Date,  Time,  Filter  Wavelength.  In  addition,  the  Exposure 
time  and  the  Intensifier  gain  arc  displayed:  "Exp:  1.0  Int:  0". 

The  next  status  line  indicates  the  number  of  points  in  the  plot.  When  the  cursor  is  dragged 
over  the  actual  plot  area  in  the  window,  the  right  hand  side  of  this  status  line  displays 
informarion  about  the  cursor  position,  such  as  the  data  #  in  the  plot,  the  pixel  location,  the 
cursor  po.sition  in  Pixel  Values,  and  the  data's  intensity. 

AutoScale  &  Manual  Scale:  The  plot  window  initially  comes  up  autoscaling  the  data.  At 
anytime,  if  you  want  to  re-autoscale  the  plot,  you  can  just  hit  the  right-hand  mouse  button 
inside  the  plot  window.  To  manually  scale  the  plot  using  the  mouse,  position  the  cursor  on 
the  start  point  (xmin,  ymin)  of  the  plot,  depress  the  left  mouse  button  and  drag  the  cursor 
to  the  end  point  (xmax,  ymax)  of  the  plot.  As  you  do  this,  a  yellow  window  will  appear 
that  represents  the  new  plot  window  to  be  created  as  demonstrated  in  the  following  figure: 
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A  new  window  will  be  created  with  the  re-scaled  plot: 


To  get  back  to  the  AutoScale  mode,  you  can  simply  hit  the  right  mouse  button  in  the  plot 
region  again.  Alternatively,  you  can  use  the  mouse  commands  under  the  Scaling  menu: 


If  you  choose  the  Manual  scaling  menu  item,  a  dialog  box  will  appear  that  allows  you  to 
manually  enter  the  min  and  max  coordinates  for  each  axes.  The  presendy  defined  limits 
will  appear  initially  in  the  edit  fields. 
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XMin: 

100 

YMIn: 

1200 

X  Max: 

300 

YMax: 

3p00 

Plot  Window  File  Operations: 

Under  the  file  Menu  in  the  plot  window,  ytxi  can  save  a  plot,  copy  it  to  the  Windows 
clipboard,  or  print  't  or  exit  the  plot  window  and  close  it.  Closing  the  MDPCTL 
app  ..tion  will  automatically  close  all  open  plot  window.*. 


Save  As:  Saving  a  plv^t  window  prompts  for  a  name  of  the  file  and  allows  you  to 

select  the  file/disk  for  the  destination  file.  The  MIPCTL  standard  file  extension  for  a  plot 
file  is  *.plt.  It  is  recommended  that  you  iicme  all  plots  with  this  extension. 

The  plot  is  saved  by  creating  an  ASCII  file  th.it  stores  the  actual  data  and  image 
information.  This  file  can  then  be  opened  from  within  the  MIPCTL  application,  viewe-^  in 
any  text  editor,  or  opened  from  within  a  spreadshe-'i  application  like  Microsoft  Exc<  I. 
Once  in  this  format,  complicated  chaits  and  analysis  features  allow  the  user  to  view  tl ; 
data.  Multiple  plots  can  be  created  by  cutting  and  pasting  spreadsheets.  In  addition,  thi. 
feature  allows  an  easy  portability  lietween  users  in  the  scientific  community. 
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An  example  of  a  plot  text  file  is  shown  in  Rgure  5.3. 


;  MIPCTL  Plot  Output  --  Text  Fonnat:  Vl.OKEO  Consultants 

Type:  PARE  ’2'.  Gaoi:  HR:UL16  T5',  NumPoints:  '362' 

BegPoint:  71  ”129'  EndPoint:  '432'  '348' 

Date:  04  Jul  92  Time:  09:15:34  76132456* 

Filt:  •  4560*  Exp:  '33'  Int:  '0' 

Int  Bit:  '33'  FieldView:  '180' 

TEMPS  -  CCD:  -26.5C  '47*  TEC:  33.5C'166'  Int:  1.5C  '103'  Filt:  24.5C  149’ 
Loc:  Rainey  Solar  Obs 
Comment:  CRESS  Campaign 


;  Data:  Index,  Value 
0  2704 

1  1754 

2  1581 

3  2025 

4  2220 

5  2238 

6  2179 
...  etc... 


Figure  5.3  --  Plot  Output  Text  File  Example 

The  first  line  in  the  plot  is  a  software  identifier.  The  next  two  lines  contain  information 
about  the  plot.  For  the  above  example,  the  user  could  repd: 

"This  plot  was  an  arbitrary  line  from  the  image  HR;IJL)  -ne  buffer.  The 

plot  has  362  points  and  started  at  point  (71,129)  and  ended  at  point  48)." 

The  next  6  lines  give  the  image  information  associated  with  the  image.  If  there  was  no 
information  defined,  a  line  would  have  indicated  this.  The  parameters  dcliminated  with  the 
'  character  are  the  instrument  values  at  the  time  of  the  image.  For  instance  the  date/bme 
string:  04  Jul  92  09:15:34  is  repiesented  as  a  4  byte  number  '76132456'  and  this  value  can 
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be  used  as  the  Unix  time  value.  These  deliminated  values  can  be  extracted  by  the  user  for 
plotting  labels,  calculations  or  whatever.  For  example,  an  Excel  MACRO  could  be  written 
to  extract  the  temperature  values,  convert  them  to  Centrigrade  and  display  them  in  a  chart 
window. 

Following  the  image  information,  the  data  occurs  sequentially.  The  first  parameter  is  the 
data  index  (or  X-axis  value),  and  the  second  parameter  is  the  intensity  data  (or  Y-axis 
value).  In  Excel,  these  values  will  automatically  appear  in  individt  1  cells,  and  thus  can  be 
immediately  used  for  charting  and  calculations. 

Printing  a  plot:  Using  the  £rint  menu  command  in  the  plot  window,  will  bring  up 

the  printing  dialog  box  of  tlie  currently  installed  printer.  A  bitmap  image  of  the  plot  will 
be  scaled  to  the  current  page  size  of  the  printer  (and  optionally  rotated  if  the  printer  driver 
supports  this  feature),  and  sent  to  the  printer  via  Window’s  Print  Manager. 

Copying  a  plot  to  the  Clipboard:  Using  the  Qopy  menu  command  in  the  plot 

window  will  send  an  image  of  the  plot  to  the  clipboard.  This  is  then  a  stfJidard  Windows 
bitmap  and  can  be  pasted  into  any  standard  Windows  application,  such  as  Word  for 
Windows,  Paintbrush,  etc.  This  is  very  useful  for  writing  reports  and  saving  images  of 
plots, 


5.3.7  MIPCTL  Image  Acquisition 

The  next  menu  item  in  the  MIPCTI..  application  is  the  Acquisition  menu  and  looks  like: 


The  Setup  menu  item  gets  the  user  into  the  Acquisition  feature  of  MIPCTL.  This  portion 
of  the  software  is  used  to  acquire  data  and  automate  acquisition  cycles.  When  collecting 
data,  this  is  the  main  window  that  will  be  used. 
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The  acquisition  window  is  divided  into  three  sections.  The  upper-left  hand  part  of  this 
window  contains  a  list  of  all  the  acquisition  events.  These  are  actions  that  are  taken  during 
an  acquisition  cycle.  The  acquisition  cycle  executes  each  event  in  the  acquisition  Ust 
sequentially.  This  cycle  will  repeat  itself  after  the  number  of  seconds  determined  by  the 
edit  field  labelled  Cycle  Time  in  the  lower  middle  of  the  window.  In  the  above  example, 
the  cycle  bme  is  30  seconds.  If  the  acquisition  cycle  takes  longer  than  30  seconds,  the 
cycle  will  stan  again  with  out  pausing. 

In  the  lv»wer  left  hand  comer  there  are  three  parameters  that  display  what  Location  and 
Comment  parameters  will  be  stored  in  the  data  acquired,  and  what  the  path  (directory)  of 
the  subsequent  image  data  will  be.  In  the  above  example,  the  image  information  headers  of 
Lhe  images  will  have: 


luxation:  Ramey  Solar  Observatory 

Comment:  CRRES  Campaign  92 


The  image  path  will  be: 


C:\mip'x;a]ibrat\ 

The  right  hand  side  of  the  acquisition  window  represents  the  information  required  to  take 
one  image.  This  is  the  defi'ult  'event'  in  an  acquisition  cycle.  As  we  will  see.  there  are 
several  otlier  events  that  can  be  defined  as  well. 
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The  sixth  entry  in  the  above  acquisition  list  is  highlighted  (or  selected),  so  it's  acquisition 
infOTtnadon  is  displayed  in  the  right  hand  side  of  the  window.  In  the  acquisition  list,  the 
event  is  represented  by  the  string: 

Fi  Gaoi  Exp  Int  min  max  rec  dfs 

6  5  DA:UL16  5.0  2  100  4000  rec 

This  could  be  read  as  "the  sixth  aq-event  nwvcs  to  filter  #5,  takes  a  Lo-Resolution  image 
using  an  exposure  of  5.0  seconds  with  the  intensificr  gain  set  a  2,  and  stores  the  image  in 
the  Gaoi;  DA:UL16.  Once  the  image  is  archived  (rec).  the  image  is  stretched  to  map  it's 
pixel  values  of  100  ->  4000  to  0  ->  4095  (thus,  increasing  the  contrast  of  the  image)". 

The  dfs  flag  is  not  set  in  this  aq-event.  DFS  stands  for  "dark-frame-subtract"  and  has  been 
disabled  in  this  version  of  the  software,  so  the  setting  of  this  flag  will  not  currently  affect 
the  actions  of  the  aq-cvent. 

This  infomiation  is  miniored  in  the  right-hand  side  of  the  window,  where  these  individual 
parameters  are  displayed  in  a  way  that  allows  the  user  to  adjust  the  values.  For  instance,  in 
the  filter  bst  box,  filter  #5  is  shown  to  be  a  1116k  filter.  If  the  user  really  wanted  this  aq- 
event  to  use  a  5511  k  filter,  the  user  would  select  this  filter  (#3)  by  selecting  the  button  in 
the  Filter  Group,  and  this  value  would  be  updated  in  the  aq-list 

Perhaps  the  user  would  also  want  to  increase  the  intensificr  gain  to  3.  The  user  would 
either  edit  the  number  in  the  Intensificr  Gain:  box,  or  change  the  value  by  selecting  the 
up-arrow  by  the  side  of  the  box.  If  the  user,  wanted  to  focus  on  looking  at  details  in  the 
darker  part  of  the  image,  they  could  change  the  maximum  mapping  value  from  4000  to  say, 
20(X),  using  the  same  approach.  Each  time  a  parameter  of  the  event  is  changed,  the  event 
string  in  the  aq-list  will  be  updated.  Thus,  after  the  above  changes,  the  event  would  look 
like; 

Fi  Gaoi  Exp  Int  min  max  rec  dfs 

6  3  DA:UL16  5.0  3  100  2000  rec 

Individual  events  can  be  selected  by  selecting  the  event  in  the  aq-list.  Once  a  new  event  is 
selected,  it's  parameters  will  be  updated  in  the  controls  on  the  nght-hand-side  of  the 
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window.  Events  can  be  inserted  aixi  deleted  using  the  standard  Windows  API  functions 
from  cither  the  Edit  menu,  or  using  the  standard  keys  such  as  Insert’  or  Delete’. 

There  are  other  events  in  the  aq-list  in  the  above  exanqrlc  that  do  not  come  under  the 
category  of  a  default  event.  There  are  prcsendy  four  other  types  of  events  defined  in  the 
MIPCTL  application;  SNAP,  PAUSE,  L<X)P  arid  Image  Arithmetic.  These  allow  you  to 
perform  other  operations  during  an  aq-cyclc  other  than  just  acquiring  data  aitd  will  be 
discussed  in  detail  in  the  following  pages.  As  the  software  evolves,  there  will  be  many 
other  operations  that  the  user  may  want  to  do  during  an  aq-cycle.  Section  6.8  describes  in 
detail  all  the  programming  steps  necessary  to  add  these  additional  functions  to  the 
acquisition  .software  of  MIPCTL. 


Acquisition  Tables: 

Acquisidon  tables  arc  ASCII  text  files  stored  on  the  hard  disk,  and  called  up  when  the 
j^etup  menu  item  is  selected  from  the  MIPCTL  menu.  The  Acquisidon  table  stores  all  the 
informadon  pertaining  to  an  acquisidon  session.  When  opening  up  the  Acquisition 
window,  MIPCTL  looks  for  the  last  acquisition  table  that  was  u.sed  in  the  acquisidon 
directory.  These  parameters  are  saved  in  the  file  KEOCCD.INI  in  directory  c:\windows. 
This  file  is  discussed  in  more  detail  in  Section  5.3. 

The  currently  opened  acquisition  table  is  displayed  in  the  Acquisidon  Window  tide.  In  the 
above  example,  the  table  open  was  tided  CUSP93.AQT.  Acquisidon  tables  have  the 
default  extension  of  *.AQT,  but  this  is  not  required.  The  at  the  end  of  the  file  name 
indicates  that  there  have  been  changes  made  in  the  file  since  it  was  last  opened  or  saved.  If 
a  new  file  is  opened,  or  this  file  is  closed,  MIPCTL  will  automatically  prompt  you  as  to 
whether  or  not  you  want  to  save  these  changes. 

These  tables  can  be  created,  opened,  rrxxlified  and  saved  from  within  the  Acquisition 
window  by  using  commands  in  the  file  menu  shown  below: 
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£icw:  Creates  a  new  empty  table.  The  first  default  aq-cvent  can  be  added  using  the 
currcniJy  selected  parameters  by  either  modifying  the  parameters  or  by  typing  the  'Insert' 
key.  The  new  table's  title  is  listed  as  <Ncw  Table>  and  once  it  has  been  modified  will  be 
displayed  as  <New  Table>'*. 

iipen:  uses  the  standard  Windows  API  to  open  an  already  existing  aq-table.  The  dialog 
box  will  display  all  files  with  extension  ♦.AQT  in  the  currently  defined  Acquisition  Table 
directory. 

Save:  allows  you  to  save  the  currently  active  acquisition  table.  If  the  name  is  already 
defined,  the  acquisition  table  is  saved  and  the  title  is  refreshed  to  reflect  it's  sute.  If  the 
table  is  a  <New  Table>*,  the  Save  As—  dialog  function  will  be  executexi. 

Save  As*  prompts  you  for  a  name  of  a  new  acquisition  table,  and  saves  it  ui  the  currently 
selected  directory.  The  new  name  is  refreshed  into  the  aq*window  title. 

Exit:  is  the  standard  Windows  API  cutiunand  to  close  the  acquisition  window.  This  can 
also  be  done  by  double-clicking  on  the  close  box  in  the  upper  left  hand  corner  of  tnc 
window.  Exiting  the  Acquisition  window,  saves  the  current  acquisition  table  if  ncccssaiy 
and  updates  the  information  in  KEOCDD.INI  to  reflect  any  changes. 


Acquisition  1'able  Format: 

The  acquisition  ublc  is  stored  on  disk  in  a  text  format  and  can  be  viewed  with  any  text 
cclitor,  A  new  (or  moditied)  acquisition  table  could  be  created  this  way.  The  acquintion 
table  defined  in  the  atxwe  example  Icxiks  like: 
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;  AQUISmON  SETUP  INFO  v2.1 
;  Written  to:  CUSP93.AQT 
;  On:  TueJul  27  11:55:53  1993 

Equipment: 

FUtcr  1  {  4278] 

FUter2(  4865J 
FUter3  (  5577] 

Filter  4  1  6300] 

FUter5[  7776] 


Location  [SRI  Site.  Sondestrom] 
Comment  (CUSP  Campaign  93] 
Cycle  Time  [30] 

Field  of  View  [180] 


Aquisition  Table: 

FILT  GAOI  EXPOS  INTTN  MIN  MAX  RHC?  DFS? 


1 

322 

10.0 

2 

0 

4095 

0 

0 

4 

326 

3.0 

2 

0 

4095 

0 

0 

-2 

326 

32.2 

322 

0 

0 

5 

0 

-6 

50 

0.0 

2 

0 

4095 

0 

0 

-7 

3 

0.4 

2 

0 

4095 

0 

0 

5 

326 

5.0 

2 

100 

4000 

1 

0 

-5 

326 

33.0 

2 

200 

3000 

0 

0 

Figure  5.4  •-  Acquisition  Table  Text  File  Example 


Tlic  acquisition  table  has  a  header  that  gives  the  version  number  of  the  acquisition  table 
format  software,  the  acquisition  table's  file  name,  the  dale  and  the  time  that  the  table  was 
written.  Next,  the  equipment  information  is  stored;  Filter  values,  the  location  and 
comment  strings  (discussed  above),  the  Cycle  time  and  the  Field-of-View  of  the  lens  used 
during  the  acquisidon  cycle.  These  acquisition  tables  are  useful  also  for  keeping  records  of 
what  different  experiment  configurations  were  used.  In  the  above  example,  the  CUSP 
experiments  in  1993  in  Sondestrom  at  the  SRI  Site,  the  filters  were  configured  as  4278, 
4865,  5577,  6300,  7776  Ang.stroms.  The  cycle  time  was  30  seconds  and  the  fisheye  lens 
(180  degree  Ficld-of-View  [FOV])  was  used  in  the  experiments. 
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Next  comes  the  List  of  aq<vents.  These  events  are  a  little  cryptic  as  they  are  translated 
when  read  back  into  the  acquisition  window.  Kowever,  from  a  programmer's  point  of 
view,  this  information  could  be  useful. 


The£dit  Menu: 

Insert,  l^lete,  Copy,  £aste.  Cu^:  The  Edit  menu  allows  you  to  use  the  standard  Windows 
GUI  commands  to  cut.  paste,  copy,  insen  and  delete  events  in  the  aq-list.  These 
comrrrands  work  like  any  standard  Window's  listbox.  To  learn  more  about  the  functionality 
of  these  commands  refer  to  the  Windows  Documentation  (or  better  yet,  experiment  with 
them!). 


equipment:  puts  up  a  dialog  box  that  allows  the  user  to  change  the  system  parameters  and 
camera  configuration. 


Filter  values  can  be  any  text  up  to  8  characters  long,  but  are  typically  inst  4  characters 
representing  tlie  filter  wavelength  in  Angstroms.  If  you  wanted  to  be  mofc  informative, 
you  could,  for  example,  label  a  filter;  '01;  6300'  where  OI  is  the  standard  noution  for  the 
atomic  oxygen  line. 

The  field-of-vicw  edit  field  (FOV)  represents  the  field  of  view  of  the  lens  cutrently  installed 
on  the  camera.  Refer  to  the  instrument’s  manual  for  the  available  lenses  and  their  FOV's 
for  the  specific  instrument.  This  can  be  anywhere  up  to  three  characters  (0  -  180). 

The  location  string  is  a  string  up  to  25  characters  long  that  records  the  location  of  the 
instrument  at  the  time  of  the  data  acquisition.  The  comment  string  is  a  string  up  to  75 
characters  long  that  records  any  other  acquisition  specific  infonnatian  that  would  be  helpful 
for  the  future  identification  of  the  dau.  A  typical  comment  string  would  hold  the 
experiment's  name  such  as  the  CRRES,  RODEO  or  CUSP  campaigns. 

The  Operations  Menu: 

The  Operations  Menu  allows  the  different  type  of  operations  to  be  added  as  entries  to  the 
aq-list.  These  operations  are  added  to  the  event  list  selecting  the  appropriate  menu  item 
from  this  menu.  Once  the  event  has  been  inserted  into  the  aq-list,  it  can  be  modified  or 
viewed  by  selecting  that  event  from  within  the  aq-lisi.  ’Opciaiion'  events  can  be  inserted, 
deleted,  cut  and  pa.sted  in  the  same  way  as  any  other  event  in  the  aq-lisL 


llie  first  four  operations  that  can  be  added  to  the  aq-list  arc  arithnittic  operations.  Tliese 
operations  arc  e.sccuted  on  the  AFG  board  hardware  and  are  therefore  done  in  'real-time' 


(<l6mscc).  The  dialog  box  is  exactly  the  same  as  the  image  math  dialog  box  from  the 
Analyze  menu  discussed  in  Section  5.3.5.  The  math  is  limited  however,  by  the  hardware,  in 
the  same  way  as  discussed  in  Section  5.3.5.  The  present  version  of  Imaging  Technology’s 
ITEX-AFG  v2.2-2,  does  not  support  the  hardware  divide  function.  Therefore,  as  of  this 
software  release,  a  divide  during  the  acquisition  cycle  is  not  permitted.  Once  an  arithmetic 
operation  has  been  entered  into  the  list  operation,  the  event  string  will  be  updated  to  look 
soroetliing  like: 

5  ADD:  DA:LR16  =  DA:UL16  +  DA:UR16 

This  represents  the  operation  that  will  be  executed  during  event  #5  of  the  acquisition  cycle. 
"Add  the  images  in  DA:IJL16  and  DA:UR16  and  store  the  result  in  DA:LR16". 

Snap/Scale:  allows  an  image  to  be  snapped  to  another  GAOI  and  scaled  through  the  input 
LUT  in  the  same  way  the  the  Stretch  LUT  operates.  The  min/max  values  represent  the 
mmimum  value  that  gets  mapped  to  zero,  and  the  maximum  value  that  gets  mapped  to 
4095  (the  Input  LUT  is  12  bits): 


In  the  above  example,  the  values  1000  to  2024  of  the  source  image  DA;UL16  get  mapped 
to  0  to  4095  in  the  destination  image  DA:UR16.  The  upper  4  bits  of  the  image  are 
unchanged.  (Note:  the  images  coming  from  the  cameras  are  12  bit  images.  Normally 
during  acquisition,  the  upper  4  bits  are  not  used.)  The  event  string  in  the  aq-list  will  now 
appear  as: 


7  SNAP:  DA:UL16  to  DA:UR16  (1000,2024) 

"The  7th  event  ui  the  atxjuisition  cycle  will  snap  a  copy  of  the  image  in  DA:UL16  to 
DA;UR16  remapping  the  values  1000  ->  2024  to  0  ->  4095  (thus  increasing  the  contrast 
of  the  image). 
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£ansc;  allows  the  user  to  let  the  event  wait  for  a  certain  amount  of  time.  This  is  useful  for 
tuning  purposes  and  to  coordinate  inner-loops  within  the  acquisition  cycle.  The  dialog  box 
looks  like: 


Pause  tor  ||2.0  | 

wes 

This  dialog  box  tells  the  event  to  wait  two  seconds  and  then  start  acting  on  the  next  event 
in  the  aq-list.  The  event  string  would  look  like: 

8  Pause:  2.0  secs 


Loop:  allows  the  user  to  loop  back  within  the  aq-list  a  certain  number  of  times.  This 
allows  multiple  loops  within  the  acquisition  cycle  which  gives  the  user  the  ability  to  write 
long  complicated  acquisition  cycles.  The  dialog  box  is  ver>'  straight  foward: 


Loop  bock  [I 


toopf  loop) 


enifie*. 


Loop  |16  S  tbwf. 


The  Loop  back  feature  will  only  allow  you  to  loop  back  to  the  fust  entry.  The  entry  string 
will  represent  this  as; 

9  LOOP  back  5  entries  16  limes 

The  £un  menu: 

The  Run  menu  allows  tlie  user  to  actually  execute  an  acquisition  cycle  or  an  individual 
event  in  that  cycle. 
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Xable,  £ntry:  starts  the  execution  of  the  whole  acquisition  table  or  the  presently  selected 
acquisition  entry.  When  either  of  these  menu  items  is  selected,  the  acquisition  setup 
window  is  hidden  and  a  new  "Run"  window  is  opened  in  the  upper-right  hand  comer  of  the 
screen: 


Select 
RUN  to 
ttwL 


O  Run 

Once 

\<S>  Run 
Fofevet 


The  user  can  now  select  whether  to  run  through  the  table  (or  entry)  once  or  whether  to  run 
continuously,  by  selecting  the  appropriate  button.  Once  this  is  selected,  the  RUN  button  is 
hit  to  actually  start  the  acquisition  session.  The  RUN  button  will  turn  into  a  PAUSE 
button  to  pause  tlie  execution.  The  EXIT  button  will  icrminafc  iht  acquisition  cycle,  and 
return  to  the  acquisition  setup  window.  During  execution  of  the  acquisition  cycle,  statue 
messages  will  appear  in  the  Run  window,  letting  the  use/  it  -:  *■  ..he  cura'm  operation  in  the 
acquisition  cycle. 


Set  Path:  allows  the  user  to  select  the  directory  where  images  arc  t  j  be  archwed  ouring 
the  acquisition  cycle.  Only  those  data-events  with  the  i.-x'  liag  selected  wiH  be  rcc?rdcxi  :o 
a  file  in  this  directory. 
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A  default  file  name  will  be  given  to  images  during  the  acquisition  cycle  with  the  format: 

YYMMDDHH.NNN  where 
YY  =  year 
MM  =  month 
DD  =day 
HH  =  hour 

NNN  =  the  number  of  the  image  taken  during  the  hour. 

For  example,  the  image  92070409.156  would  be  the  156th  image  take  during  the  hour  of 
0900  on  July  4th,  1992.  For  consistency,  all  data  should  stored  in  UT  or  Universal  Time. 
To  do  this,  set  the  computer's  clock  to  UT  time  from  Window’s  Control  Panel. 

Display  Image,  Display  Quadrant:  allows  the  user  to  decide  whether  they  would  like  the 
currently  active  image  to  be  displayed  solcy  on  the  monitor,  or  whether  the  whole  quadrant 
that  the  image  is  in  should  be  displayed  Selecting  this  menu  item,  toggles  the  option  back 
and  forth  between  Image  and  Quadrant. 


5.3.8  Tlie  Help  Menu 


About  MipCtI:  Ihe  About  dialog  box  is  a  helpful  tool  of  the  MIPCTL  application.  It 
is  dynamically  updated  to  give  information  on  both  the  MIFCTL  application's  environrrtent 
and  Windows  3.1'$  environment.  The  About  box  displays  the  current  date  and  tune  which 
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is  useful  for  checking  against  a  known  time  source.  If  the  time  has  drifted  or  needs  to  be 
reset,  'Jiis  can  be  done  via  the  Windows  3.1  Control  panel  (in  menu  MAIN). 


The  About  box  also  displays  MIPCFL's  software  version  and  the  date  this  software  was 
last  updated.  This  is  useful  for  checking  image  header  information  and  making  sure  the 
instrument  has  the  nio.'vt  recent  software  update. 

The  monitor,  camera  head,  and  COMM  port  currently  selected  (and  set  in  KEOCCD.INI) 
are  displayed.  In  the  above  case,  the  software  was  run  using  an  NEC  MultiSync  SFGx 
monitor,  the  HA  \RP  camera  head,  and  COM4  for  a  communications  pon. 

Finally,  the  About  box  displays  information  about  the  Windows  environmenL  Both  the 
Windows  and  POS  version  numben  are  displayed  and  the  percentage  of  system  resources 
currently  available.  Next,  the  amount  of  available  Local  Memory  and  Global  Memory  are 
displayed.  To  fully  understand  what  these  parameiers  arc,  refer  to  tiic  Windows 
documentation.  However,  t.hesc  parameters  arc  important  to  check  and  make  sure  that  the 
Windows  environment  and  the  MIPCTL  applicauon  are  behaving  properly.  The  above 
values  are  typical. 

If  the  MIPCTL  application  starts  runrung  .slowly,  and  windows  ^ake  a  long  time  to  draw, 
something  is  probably  corrupting  the  Windows  environment.  To  check  and  see  the  affect 
of  the  MIPCTL  application,  the  user  can  look  at  the  system  resources  by  looking  at  this 
dialog  box  and  then  close  the  MIPCTL  application. 
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Once  the  application  is  closed,  the  user  can  check  the  system  resources  by  using  the 
About...  dialog  lx)x  Irom  Window's  Program  Manager  window  to  sec  the  difference  in 
system  resources  and  hence  how  much  of  the  system  environment  MIPCTL  was  using. 
These  features  are  most  useful  for  debugging  in  the  programming  environment,  and  are  not 
typically  needed  for  the  use  of  MIPCTL. 


5.4  KEOCCD.INI:  System  Initialization 

The  KEOCCD.INI  file  follows  the  standard  Windows  3. 1  API  for  maintaining  application 
specific  initialization  information.  This  file  is  kept  in  the  windows  directory; 

C:\Windows\ 

This  file  is  a  standard  text  file  and  can  be  viewed  with  a  text  editor  just  like  any  Windows 
TNI’  file  (such  as  WIN. INI  and  SYSTEM.INI).  A  typical  KEOCCD.INI  file  is  shown  in 
Figure  5.5. 


(Camera  Settings] 
Gain=0 
Binning=l 
Camera=HRP 


(System] 

Zoom- 100 

Justify=200 

Display=I5 

Port=COM4 

Moniior=3FGx 

(CCD  Aquisilion] 
AqiPaih=C:\MIPvMIPCrL\ 
ImgPaih=c:Nmip'ealibrai 
UslTable=CUSP93.AQT 


Figure  5.5  --  KEOCCD.INI  Text  File  Example 


The  first  heading  [Camera  Settings]  gives  the  iniiia]  settings  of  the  camera  head.  Gain 
sets  the  camera  analog  gain  before  it's  conversion  to  digital  information  This  controls  the 
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dynamic  range  and  sensitivity  of  the  instrument.  Gain  values  can  be  0,  1,  or  2 
corresponding  to  HI,  MID,  and  LOW. 

Binning  can  be  either  1  or  2  and  correspond  to  the  Hi  and  Lo  Resolution  images  (1x1 
binning  verses  2x2  binning). 

Camera  corresponds  to  which  camera  head  is  being  used.  The  current  heads  available  are 
MIP  (MIP)  or  HRP  (HAARP).  It  is  in^xjrtant  to  keep  track  of  which  instrument  is 
collecting  data  as  the  flat-field,  calibration,  and  orientations  are  different  for  the  different 
instruments. 

The  second  heading  (System]  sets  the  MIPCTL  application's  system  parameters  and 
stores  the  status  of  the  system  as  it  was  last  used: 

Zoom  determines  which  zoom  factor  was  used  on  the  AFG  board  and  sets  the  current 
zoom  to  that  value.  AFG  allows  zooming  factors  of  1,  2,  4,  and  1/2.  The  numbers  stored 
in  KEOCCD.INI  do  not  directly  correspond  to  these  values  but  rather  to  their 
representation  in  the  program. 

Justify  determines  the  justification  of  display  and  can  be  set  to  top,  center  and  bottom. 
Again,  the  numerical  values  in  KEOCCD.INI  correspond  to  the  program's  representauon 
of  these  values. 

Display  sets  which  image  is  currently  displayed  as  the  top  left  hand  image.  In  AFG  terms, 
this  sets  the  Pan  and  Scroll  of  the  display.  Again,  the  numerical  values  in  KEOCCD.INI 
correspond  to  the  program's  represenution  of  these  values. 

Port  determines  which  valid  Windows  communications  fx>rt  is  used  to  communicate  to  the 
camera.  The  valid  entries  are  COMl,  COM2,  COM3,  COM4.  Currently,  the  HAARP 
hardware  is  S'.Jiup  for  the  use  of  COM4. 

Monitor  determines  what  monitor  is  connected  to  the  computer  system.  This  is  important 
as  it  affects  the  screen  calibration  between  AFG  pixels  (not  linear  in  space)  witli  the  VGA 
pixels  (see  Section  6.5).  The  two  monitors  presently  defined  for  the  system  are  MIP's 
"3D"  monitor  (the  NEC  3D  14”  MnltiSync)  and  HAARP's  ”3FGx"  (the  NEC  3FGx  15" 
MultiSync). 
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The  values  in  KEOCCD.INI  are  usually  maintained  by  the  program  itself.  The  two 
parameters  that  should  be  changed  manually  using  the  text  editor  are  the  Camera  (MIP  or 
HRP)  and  the  Monitor  (3D  or  3FGx).  These  parameters  can  be  checked  when  running 
MEPCTL  by  using  the  About  MIPCTL...  menu  command  discussed  in  Section  5.3.8. 

Occasionally,  such  as  during  a  system  crash,  KEOCCD.INI  can  be  coirupted  (or  even  lost). 
When  this  happens,  use  the  text  editor  to  correct  the  corrupted  variables  such  as: 

Monitor  =  ckjoife  -->  Monitor  =  3FGx 

If  KEOCCD.INI  has  been  destroyed  completely,  create  a  new  one  in  the  directory 
C:\Windows\  and  copy  the  above  text  from  the  example  KEOCCD.INI  uyloring  the  entries 
as  needed.  Then  restan  the  MIPCTL  application  and  check  that  it  is  working  correctly. 

5.5  Notes  on  AFG  Failure 

If  it  appears  that  there  are  problems  with  the  AFG  board,  it  may  be  a  software  problem 
with  the  ITEX  drivers.  If  problems  arise,  there  are  several  things  that  you  can  try  to 
unlock  the  system.  The  following  is  a  step  through  of  some  things  that  can  unlock  the 
board.  You  may  try  all  or  some  of  the  following. 

To  see  if  there  is  a  problem,  you  can  first  just  exit  whatever  program  you  ar  e  using  to  talk 
to  the  AFG  (such  as  MIPCTL  or  EVTRP)  and  then  try  to  restan  it.  If  the  AFG  board 
driver  is  locked  up  somehow,  you  will  get  an  error  message  during  die  initialization  of  the 
board  that  will  look  something  like: 

TIGA  Error  ...  07EH... .Couldn't ... 

Exit  your  program  (if  it  didn't  exit  automatically),  and  enter  Imaging  Technology's  board 
debugger  utility  DX.  If  in  DOS,  go  to  directory  ADGDX  and  type  DX: 

C:>  cd  Wgdx 
C:>  dx 

Or  if  you  are  in  vrindows,  just  double  click  on  the  DX  Icon  in  the  AFG  Window. 
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The  DX  software  will  prompt  you  for  a  configuration  file.  Type; 

KEO 

after  which  DX  will  read  this  file  and  set  up  the  board  and  return  a  prompt. 

Type  the  following  sequence  of  commands  waiting  for  a  prompt  before  going  to  the  next 
command; 


>init 

>cxtendcd 
>tcst  1 
>init 

>swrst  =  1 

>swrst 

>exit 


;  Initializes  the  AFG  Board 
;  Gives  you  the  extended  commands  of  DX 
;  resets  all  the  registers  on  the  AFG  board 

;  Starts  a  software  reset 
;  Completes  a  software  reset 


It  is  usually  unnecessary  to  do  a  "test  1 ",  but  this  just  makes  sure  your  hardware  is  running 
correctly.  "SWRST  =  1 "  and  "S WRST"  must  be  done  together  and  it  executes  a  software 
reset  on  the  board. 


Once  this  is  done,  you  can  also  try  and  reload  the  TIGACD  TSR  to  sec  if  that  had  been 
corrupted  in  any  way.  From  DOS,  type: 

tigacd  -u 
tigacd 
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Chapter  6  Programming  Details 


6.1  ITEX  Image  File  format 

Images  saved  to  disk  by  the  MIPCTL  application  are  stored  in  the  I'l  EX  Image  Hie 
format  Details  are  provided  in  Appendix  A  of  the  ITEX-AFG  Software  Manual  provided 

by  Imaging  Technology. 

An  outline  of  the  image  format  is  provided  here  for  convenience. 

An  Image  File  has  the  following  byte  format: 

Bvtes 

Contents 

0-1 

Characters  7M'  indicate  this  is  an  image  file 

2-3 

Comment  Length 

4-5 

Width  of  image  in  pixels 

6-7 

Height  of  image  in  pixels 

8-9 

Coordinates  of  (niginal  X-axis  position  (horizontal) 

10-11 

Coordinates  of  original  Y-axis  position  (vertical) 

12-13 

File  type  flag: 

0  -  EIGHT.BIT 

1  -  COMPRESSED 

2  -  sixteen.bit 

14-63 

Reserved 

64  -  nnn 

Comment  Area  —  variable  length;  200  bytes  maximum 

nnn+l  --  End  Data  Area:  one  bytc/pixcl  (8  Bits)  or  two  byics/pixcl 
stored  in  row  order,  from  the  top  to  the  bottom  of 
the  image. 

Figure  6.1  --  ITEX  image  File  Format 


Data  is  stored  in  the  Intel  byte  format:  Least  significant  byte  first,  Most  significant  byte 
second.  (This  is  the  opposite  of  68000  based  systems:  i.e.  ASIPU  Multibus,  Macintosh 
systems.) 
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6.2  Image  Infomiation  and  the  Image  Comment 


The  comment  field  of  the  Image  File  is  used  to  store  image  information.  The  image 
information  is  a  '$nt^>shot'  of  the  imager  when  the  image  was  acquired.  Images  stored 
using  the  MIPCTL  acquisition  system  will  automatically  have  image  information  stamped 
into  the  comment  field.  Other  images,  created  by  other  applications  or  by  saving  an  image 
with  no  image  information  structure,  will  have  a  nulled  comment  field.  The  current 
software  version  (vS.3.2)  stamps  the  image  information  into  the  comment  field  with  the 
following  format.  Refer  to  Section  6.9  for  a  chronological  version  history  of  the  comment 
field  formaL 


KE05.3  HRP;22  Jiil  93  09;23;48  G[1JWI  4278)E{  l5)V[180]C[63]T(189)Itl(X)]Ffl40)B123] 
-1-1-  Rainey  Solar  Observatory  CRRES  *93 

-\127\7Tvll\95M90" 

Figure  6.2  -  Image  Information  Comment  String 


This  comment  siring  is  200  bytes  long  including  a  termination  character.  The  first  6 
characters;  KE05.3  indendfy  this  comment  as  a  KEO-created  comment  from  software 
version  5.3.  This  software  version  can  then  be  used  to  translate  the  following  characters 
using  Section  6.9. 

HRP:  indcntifics  the  camera  head  used  to  acquire  the  image  a  d  next  comes  a  text  version 
of  the  date  and  time  of  acquisition:  22  Jul  93  09:23:48.  'Phis  information  is  stamped  into 
the  image  comment  so  that  anyone  dumping  the  image  file,  will  be  able  to  easily  idendfiy 
this  information. 

Next  comes  a  string  of  system  parameters  in  the  format  X(NNN]  where  X  is  a  one 
character  indentifier  for  the  parameter  and  enclosed  in  square  brackets  is  an  ASCII 
representation  of  the  parameter's  value.  This  is  not  as  space  efficient  as  storing  the 
information  in  binary  format,  but  has  the  advantage  of  being  easily  readable  witJiout  any 
software  translation  (e.g.  a  user  can  use  a  simple  file  dump).  The  parameters  are  taken 
directly  from  the  image's  infomation  structure; 
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G  =  Intensifier  Gain  (1  byte) 

E  =  Exposure  Time  (3  bytes) 
C  =  CCD  Teit^.  (3  bytes) 

1  =  Intensifier  Temp.  (3  bytes) 
B  c  inL  Brightness  (3  bytes) 


W  =  Filter  Wavelength  (8  bytes) 
V  =  Field  of  View  (3  bytes) 

T  =  TEC  Temp.  (3  bytes) 

F  =  Biter  Wheel  Temp.  (3  bytes) 


The  next  5  characters  of  the  suing  ('I*!-)  indicate  the  values  of  the  Camera  Gain  (cGain  = 
1  [Mid-Gain] )  and  the  Binning  factor  (cBin  s  2x2).  The  next  26  characters  are  reserved 
for  the  Location  string  (25  char  long)  with  leading  spaces  (one  extra)  followed  by  76 
characters  for  the  Comment  string  (75  char  long)  with  leading  spaces  (one  extra). 

Finally,  in  the  above  example  arc  the  characters  -\I27M)_%\0.  These  arc  the  last  7 
characters  of  the  comment  suing.  The  first  character  is  a  delimiter  between  the 
comment  string  and  the  binary  tune  variable  that  follows  in  the  next  5  bytes.  The  last 
character  is  the  null  character  ^0'  that  terminates  the  string. 


The  binary  time  is  encoded  into  the  comment  field  so  that  software  will  readily  be  able  to 
identify  the  time  using  the  Unix  Time  Format  supported  by  C.  Tlie  first  byte  is  a  status 
byte  that  indentifics  any  byie.s  with  value  0  in  the  four  byte  time  variable.  The  0  byte  is 
then  set  to  127  to  ensure  that  it  does  not  prematurely  null  the  suing  when  it  is  written  to 
the  image  file.  This  is  described  in  more  detail  in  Section  6.9. 

6.3  Minimum  Files  needed  lo  run  MEPCTL 


This  section  outlines  the  mmimum  files  and  their  directory  structure  to  run  the  MIPCTL 
application.  This  manual  docs  not  discuss  the  necessary  files  for  the  Imaging  Technology 
AFG  Board  and  ITEX  software.  Refer  to  the  ITEX  Release  Notes  v2.2-2  for  this 
information. 


MIPCTL  files: 


C:\WlNDOWSNKEOCCD.INI 
C;\WlNDOWS^AOI.DLL 
C  \Wl^^DOW.'^OSW.DLL 

C:\VlS^rPLU5CONFIC^MIP.CAM 

C:\VISt'ft>LUSrCONFIOvm).CNF 

C;\VlSNPLUS<.'ONFIG\KLO.MON 


:  Initialization  file 

;  Gaoi  Control  DLL  tile  for  dialog  boxes 
;  Graphics  .Server  DLl.  fJe  for  ptotting  Wins 

;  Camera  head  definitions  for  ITEX  code 
;  Configuraiion  definitions  for  ITEX  code 
;  Monitor  definitions  for  ITEX  code 
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Files  in  the  same  dinectofy  (usually  \MIFNMIPCTL): 

MIPCrL£XE  ;  Executable  usually  in  \MIPvMIPCrL 

MIPIJ’NT  :  TIGA  large  font:  same  dir  as  MIPCTL£XE 

MIP2,FNT  :  TIGA  small  font  same  dir  as  MIPCTL.EXE 

TEMPTURE.LUT  ;  Temperature  LUT  --  will  be  created  if  none 

VGA2AFGI-inr  ;  VGA  2  AFG  coordinates  LUT -will  be  created 

:  if  none 


6.4  Files  and  Directory  Structure  for  Program  Development 


This  sections  describes  all  the  files  needed  (as  of  v5.3.2)  for  program  development  of  the 
MIPCTL  application  and  associated  DLL's.  The  directory  structure  is  flexible  and  can  be 
changed,  but  care  must  be  taken  to  make  sure  that  paths  are.  changed  in  the  source  code  to 
reflect  these  changes  if  the  structure  of  the  directories  is  changed. 


The  MIP  development  code  is  in  the  directory  C:NMIP: 


CDmip 

I-  CDcaibrat 


CDendi 
Ooaoi 
f-  CD  document 
[-Olofth 
images 
I-CDco 
^CDmipctJ 
'“CUdald-aq 
^CDaQiii 


Figure  6.3  --  MEPCTL  Directory  Structure 
The  directories  in  MIP  hold  the  following  information; 


\CALIBRAT 

\DLL\ERRDLL 

\DLL\GAOI 

NDOCUMENT 

\FORTH 


Calibrabon  images:  not  necessary  for  development 
An  Error  Logging  DLL:  not  implemented  in  v5.3.2 
The  GAOI  Custom  Control  DLL:  Necessary 
Documentation  for  HAARP:  not  necessary 
The  FORTH  and  DSP56001  code  for  the  Adv.  Tech 
controller  board.  Not  necessary  for  MDPCTTL  program 
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MMAGES 

MOO 

WQPCTL 

NMEPCTLNDATA-AQ 

\MIP\DATA-AQNAQUIS 


;  developnacnt,  but  necessary  for  development  of  the  control 
;  electronics  system 

;  Images  stored  on  disk;  not  necessary  for  development 
;  Image  Overiay  Object  Code:  Necessary 
;  MIPCTL.EXE  development  code:  Necessary 
;  Acquisition  development  code;  Necessary 
;  Acquisition  dig  resources:  Necessary 


F^r  the  directories  that  arc  necessary  for  program  development  of  the  MIPCrL£XE 
application,  the  following  files  are  required: 


GAOl  DLL  Development:  development  of  the  GAOl  custom  control  DLL: 


Directory:  C:\MIPvDLL\GAOI 


gaoi.DEF 

gaoi. 

LibEntry.obj 

gaoi.DLL 

gaoi. LIB 

gaoi.Res 

gaoi.c 

gaoi2.c 

gaoi. re 

gaoi.h 

gaoi.dlg 

dialog.h 

quadsel.h 

quadsel.dlg 

quadsel.res 


Definition  file  for  the  DLL  executable 

External  NMAKE  file  fcM*  building  DLL 

DLL  entry  assembly  code 

Final  DLL:  copied  into  Windows  directory 

Final  Library  file:  copied  into  c:\mip\mipctl 

Compiled  resource  file  for  DLL  using  Resource  Compiler 

DLL  C  code:  File#l 

DLL  C  code:  File  #2 

Resource  file 

DLL  function  definition  lidr  file;  copied  into  c:MTiipNmipctl 

Custom  Control  Dialog  box 

Dialog  box  IDD  definition  header  file 

Quad  Select  Dialog  box  IDD  definition  header  file 

Quad  Select  Dialog  box 

Resource  file  for  dig  box  create  from  Dialog  Editor 


Image  Overlay  Object  Development: 


Directory:  C:\MIFMOO 


ioo.c 


;  Image  Overlay  Object  Code 
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ioo.h 

ioownd.c 

ioowndh 


Image  Overlay  Object  function  definition  header  file 
lOO  Window  Code 

lOO  Window  function  definition  header  file 


L.EXE  Program  Development: 


C  source  code 


Directory:  C:\MIPvMIPCIl, 


Q  erras  c 

2030 

Qfledgc 

16006 

Qmpantzec 

71440 

Gfnpccdc 

12073 

Q  mipcfitflc 

15353 

Gtnocomttic 

15206 

Gmipdsptc 

41545 

Q  mipfinfo.c 

41008 

G'niprtiLc 

32571 

Qmipmairic 

5080 

QmpmatKc 

9511 

Qtnipplotc 

82887 

Qnipwndlpr.c 

22235 

5^4/93  12:02:3Spm 
7/15/^  5;55:42pm 

7720/93  1;mi0pm 
7/27/93  3:37  1 2pfn 

7/23/93  1200:30pm 
5/10/93  256:04pm 

7/22m  11:54;30am 
7/16/93  1:31:34pro 

7/23/93  11:58;28am 
5/13/93  93244am 

5/13/93  956:20^ 

7/15^  930:1  Sam 

7/23/93  1201:52Dm 


errors. c 

filedlg.c 

mipanlze.c 

mipccd.c 

mipcntrl.c 

mipcomnLC 

mipdispl.c 

mipfinfo.c 

mipiniLc 

mipmain.c 

mipmath.c 

mipploLC 

mipwndpr.c 


Report  errors  to  a  message  box  handler 
handles  file  dialogs  for  Save/Restore  Images 
handles  functions  for  code  in  Analyze  menu 
handles  functions  for  code  in  CCD  menu 
handles  functions  for  code  in  Controls  menu 
handles  functions  for  communications  to  camera  head 
handles  functions  for  code  in  Display  menu 
handles  functions  for  image  information  and  image  files 
handles  functions  for  system  initialization 
WinMain  function  for  MIPCTL.EXE 
handles  functions  for  image  arithmetic 
handles  functions  for  plotting  windows  and  dig  boxes 
Window  procedure  for  main  window 
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Directory:  C:\MIPvMIPCrL\DATA-AQ 


Qaqenby.c 

171S2 

1/3/93 

359;4ep(n 

Qaqfleclgc 

11727 

5/13/93 

120S:2(]bm 

D  aiin«grnth.c 

28534 

5/13/93 

1210: 4Qpn) 

Q  aqnjfic 

347S 

7/23/93 

1204:52pfn 

42047 

6/2/93 

941:56^ 

QaqtaUec 

7323 

12/11/92 

1:31:5^ 

DaqLBC 

1123 

8/7/92 

ia50:02«i) 

aqcntiy.c 

aqfiledg.c 

aqimgmth.c 

aqrun.c 

aqsetup.c 

aqtable.c 

aquis.c 


handles  functions  for  the  acquisition  entry 
handles  functions  for  acquisition  table  file  i/o 
handles  filiations  for  image  math  op's  during  acquisition 
handles  functions  for  running  acquisition  table 
handles  functions  for  the  setup  window 
handles  functions  for  the  table  of  event  entries 
general  definitions  for  acquisition  window  code 


MIPCTL.EXE  Program  Development:  Header  Files  for  C  Code 


Directory:  C:\MIFNMIPCTL 


ccdcmds.h 

;  header  for  CCD  command  characters 

errids.h 

;  header  fw  error  string  ID  numbers 

library.h 

;  header  for  file  library  #includes 

mipctl.h 

;  function  definitions  and  system  #dcfines 

mipextm.h 

;  external  variable  declarations 

mipglbis.h 

;  global  variable  declarations:  used  in  mipmain.c 

miphead.h 

;  general  header  file  used  for  most  C  code 

gaoi.h 

;  header  file  for  GAOI  custom  control  functions 

Directory:  C:\MIPSMIPCTL\DATA-AQ 

aquidds.h 

;  header  file  for  aqsetup  window  control  idd's 

aqsetup.h 

;  header  file  for  aqsetup  window  functions 

aqtable.h 

;  header  file  for  aq-table  functions 

aquis.h 

;  header  file  for  acquisition  structures 

aqfile.h 

;  header  file  for  aq-table  file  i/o  functions 
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Resource  files  created  by  Microsoft  C7's  Dialog  Editor 


Directory:  C:\MIPSMIPCTL 

about.res 

afgclearjes 

ccdset.res 

cleaiovl.res 

cursor.res 

disimage.res 

FileOpen.res 

FileSave.res 

Histogrm-res 

imagiiifo.res 

ImgMath.res 

labelim.res 

loop.res 

LUTSelct.res 

Manlinfo.res 

Observe.res 

pause.res 

PloiArb.res 

PliParam.res 

quadrant.res 

SelctROI.res 

Settings.res 

Shutters.res 

SnapGaoi.res 

SndMip.res 

Stats.res 

Stretch.res 

Tempture.res 

video.res 


about  dialog  box 

clear  afg  memory  dialog  box 

CCD  Settings  dialog  box 

clear  looWnd  graphics  dialog  box  (overlay) 

Cursor  dialog  box 

Display  Image  dialog  box 

Restore  Image  'open'  dialog  box 

Save  Image  'save'  dialog  box 

Get  a  Historgram  dialog  box 

Image  Information  dialog  box 

Image  Arithmetic  dialog  box 

Label  Image  with  Iminfo  dialog  box 

Loop  operation  (A(^)  dialog  box 

Select  an  Output/Input  LUT  dialog  box 

Manual  Dimensions  for  plot  windows  dialog  box 

Observe/Dark  dialog  box 

Pause  operation  (AQ)  dialog  box 

Get  Arbitrary  Plot  dialog  box 

Get  Row/Column  Plot  dialog  box 

Quadrant  select  dialog  box 

Select  a  ROI  dialog  box 

Comm  Settings  dialog  box 

Shutters  control  dialog  box 

Snap  GAOI  Utility  dialog  box 

Send  CCD  Command  dialog  box  (shrunk) 

Statistics  dialog  box 

Stretch  LUT  dialog  box 

Temperature  display  dialog  box. 

Video  attributes  dialog  box 
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Directoiy;  C:\MIPSMIPCTL\D/  TA-AQ\AQUIS 


aqentry.res  ;  AQ  —  enn7  window  dialog  box  (nxxlcless) 

aqequip.res  ;  AQ  --  Set  Equipment  dialog  box 

aqrun.res  ;  AQ  --  run  dialog  box 

setpath  jes  ;  AQ  -  Set  Image  path  dialog  box 


Header  files  created  by  Microsoft  C7's  Dialog  Editor 
Directory;  C:\MIF^MIPCTI. 


about.h 

afgclear.h 

ccdset.h 

clearovl.h 

cursor.h 

disimage.h 

displ.h 

filedlg.h 

Hisiogrm.h 

irnaginfo.h 

ImgMath.h 

labelirah 

loop.h 

LUTSelcth 

Manlinfo.h 

MipCntrl.h 

Observe.h 

pause,  h 

PlotArb.h 

PltParam.h 

quadrant.h 

SelctROI.h 

Settings. h 


about  dialog  box 

clear  afg  memory  dialog  box 

CCD  Settings  dialog  box 

clear  looWnd  graphics  dialog  box  (overlay) 

Cursor  dialog  box 

Display  Image  dialog  box 

Definitions  for  display  im/quad  boxes 

image  save/restore  dialog  definitions 

Get  a  Historgram  dialog  box 

Image  Information  dialog  box 

Image  Arithmetic  dialog  box 

Label  Image  with  Iminfo  dialog  box 

Loop  operation  (AQ)  dialog  box 

Select  an  Output/Input  LUT  dialog  box 

Manual  Dimensions  for  plot  windows  dialog  box 

Filterwheel  and  Intensifier  control  dialog  box 

Observe/Dark  dialog  box 

Pause  operation  (AQ)  dialog  box 

Get  Arbitrary  Plot  dialog  box 

Get  Row/Column  Plot  dialog  box 

Quadrant  select  dialog  box 

Select  a  ROI  dialog  box 

Comm  Settings  dialog  box 
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S  butters,  h 

SnapGaoi.h 

Stats.h 

Stretch.h 

Teinpturc.h 

video.h 


;  Shutters  control  dialog  box 
;  Snap  GAOI  Utility  dialog  box 
;  Statistics  dialog  box 
;  Stretch  LUT  dialog  box 
;  Temperature  display  dialog  box 
;  Video  attributes  dialog  box 


Directory:  C:\MIPvMIPCrLNDATA-AQ 


aqentry.h  ;  AQ  -  entry  window  dialog  box  (modeless) 

'aquisSaqequip.h  ;  AQ  --  Set  Equipment  dialog  box 

MTPCTL.EXE  Program  Development: _ PialQ>.  filei  fcr  dialog  1 QX2S 

Dialog  files  created  by  Microsof:  C7's  Dialog  Editor 

Dire';tory:  C:\MEPNMIPCnL 


about.dlg 

afgclear.dlg 

ccdset.dlg 

clearovl.dlg 

cursor.dlg 

disimage.dlg 

fileopen.dlg 

filesavc.dlg 

Histogrm.dlg 

unagipfo.dlg 

ImgMath.dlg 

labelinxdlg 

loop.dlg 

LUTSelct.dlg 

Manllnfo.dlg 

MipCntrl.dJg 

Observc.dlg 

pause.dlg 

PlotArb.dlg 


about  dialog  box 

clear  afg  memory  dialog  box 

CCD  Settings  dialog  box 

clt  tr  looWnd  graphics  dialog  box  (overlay) 

Cursor  dialog  box 

Display  Image  dialog  box 

image  open  dialog  box 

image  save  dialog  box 

Get  a  Hisiorgram  dialog  box 

Image  Information  dialog  box 

Image  Arithmetic  dialog  box 

Label  Image  with  Iminfo  dialog  box 

Loop  operation  (AQ)  dialog  box 

Select  an  Output/Input  LUT  dialog  box 

Mariual  Dimensions  for  plot  windows  dialog  box 

Filterwheel  and  Iiitensifier  control  dialog  box 

Observe/Dark  dialog  box 

Pause  operation  (AQ_)  dialog  box 

Get  Arbitrary  Plot  dialog  box 
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PltParam.dlg 

quadrantdlg 

SelctROI.dlg 

Settings.dlg 

ShuttCTs.dlg 

SnapGaoi.dlg 

SndMip.dlg 

Stats.dlg 

Stretch. dig 

Tempture.dlg 

video.dig 


Get  Row/Column  Plot  dialog  box 

Quadrant  select  dialog  box 

Select  a  ROI  dialog  box 

Gxnm  Settings  dialog  box 

Shutters  control  dialog  box 

Sntqj  GAOI  Utility  dialog  box 

Dialog  Box  for  Sending  Command  to  camera 

Statistics  dialog  box 

Stretch  LUT  dialog  box 

Temperature  display  dialog  box 

Video  attributes  dialog  box 


Directory:  C:\MIRMIPCTL\DATA-AQvAQUIS 


aqentry.dlg 

aqequip.dlg 

aqrun.dlg 

aqtable.dlg 

fileopen.dlg 

filesave.dlg 

setpath.dlg 


AQ  --  entry  window  dialog  box  (modeless) 
AQ  ”  set  equipment  dialog  box 
AQ  -  run  dialog  box 
AQ  ”  table  dialog  box  (modeless) 

AQ  --  open  aq-table  dialog  box 
AQ  “  save  aq*table  dialog  box 
AQ  “  set  image  path  dialog  box 


MIPCTL.EXE  Program  Development: _ Resource  Files 


Directory .  C:\MIP\MIPCTL 

mnarrdn.bmp 

mnarrup.bmp 

mxairdn.brnp 

mxarrup.bmp 

camera.cur 

crsshair.cur 

iiiipl.fnt 

mip2.fnt 

errids.h 

IZbitcol.ico 


Min  Arrow  (down)  bitmap  for  LUTStretch 
Min  Arrow  (up)  bitmap  for  LUTStretch 
Max  Arrow  (down)  bitmap  for  LUTStretch 
Max  Arrow  (up)  bitmap  for  LUTStretch 
Camera  Cursor 
Crosshair  Cursor 

TIG  A  font  for  1x1  binning  labeling 
TIGA  font  for  2x2  binning  labeling 
Header  file  for  error  string  table 
Icon  for  12  bit  psuedo-color  LUT 
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12bitlin.ico 

Sbiilin.ico 

camcntrLico 

plotwnd.ico 

strchlutico 

errstmg.rc 


Icon  for  12  bit  linear  monochrome  LUT 
Icon  for  8  bit  linear  nx>nochrDine  LUT 
MIPCTL  ICON  f  or  application 
Icon  for  minimized  plot  window 
Icon  foi  LUTStrctch  Dig 
String  table  for  ‘'Error"  messages 


L.EXE  Propram  Development: 


Compilation  files 


Directory;  C:\MIP\MIPCTL 


Mipctl.def 

Mipctl.exe 

Gaci.Iib 

Mipctl.lnk 

Mipcd.mak 

Miprel.mak 

Mipctl.map 

Mipextm.pch 

Mipcd.pif 

Mipctl.rc 

Mipctl.res 


Definition  file  for  Windows  application 
Final  Executable  Application:  MIPCIL 
GAOI  control  link  library  for  LINKING  application 
Link  control  file  for  LINKING  application 
NMAKE  .mak  file  for  debug  version:  MIPCTL.EXE 
NMAKE  .mak  file  for  release  version:  MIPCTL.EXE 
MJPCTL  map  file  of  executable  file  MIPCTL.EXE 
Precompiled  header  file  for  Compile  session  re-created 
during  a  REBUILD  from  Visual  C-f-f 
Windows  .PIF  file 
Resource  File 

Compiled  resource  file  using  Resource  Compiler’ 


Files  CTfaisd  t?Y  MIPCIL-EXE 


Directory;  C:\MIPNMIPCTL 


*.aqt 

*.plt 

*.img 

tempture.lut 

vga2afg.lut 


;  Acquisition  table  files  {ASCD) 

;  Plot  Files  (ASCID 
;  Images  (Binary) 

;  Temperature  LU'i  for  ADC  conversion  (ASCII) 

;  VGA  coordinates  to  AFG  coordinates  LUT  (ASCII) 
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6.5  Monitor  Calibration  using  the  AFG  board 


The  video  from  the  VGA  display  card  in  the  computer  is  mixed  with  the  video  output  of 
the  frame  grabber  card.  Thus,  the  monitor  can  be  thought  of  as  two  overiayed  images. 
Depending  on  the  Video  mode  set  in  the  MIPCTL  software  v'Section  5.3.4),  a 
combination  of  the  two  displays  will  appear  at  any  one  time  on  the  monitor.  ITieie  is  often 
a  need  to  translate  from  a  pixel  location  in  the  AFG  video  to  a  pixel  location  in  the  VGA 
(computer's)  video  signal  and  vice-versa. 

An  example  of  translating  from  AFG  pixels  to  VGA  pixies  (AFG2Vga)  would  be  to  draw 
a  line  in  the  Image  Overlay  Window  of  AFG  pixel  locations  xl,yl  to  x2,y2  (lo.o’Vnd  is  in 
VGA  video).  In  this  case,  we  need  to  translate  the  AFG  pixel  locations  to  VGA  jnxel 
locations  and  draw  at  these  pixel  locations  in  the  VGA  screen. 

An  example  of  translating  from  VGA  pixels  to  AFG  pixels  (Vga2AFG)  would  be  to 
identify  a  pixel  intensity  at  the  present  CURSOR  location.  Since  the  cursor  is  drawn  in  the 
VGA  video,  it's  location  is  given  in  VGA  pixel  coordinates.  We  would  need  to  translate 
this  point  in  VGA  coordinates  to  it's  coiresponding  point  in  AFG  coordinates  and  read  this 
value  to  get  the  pixel  intensity  at  the  CURSOR  location. 

In  order  to  do  this,  the  monitor  must  be  calibrated  with  the  AFG  board.  This  is  done  by 
drawing  cross-hairs  of  known  location  into  the  AFG  buffer  (say  every  1(X)  pixels  in  x  and 
y),  and  then  positioning  the  cursor  over  these  cross  hairs  and  reading  their  positions.  This 
calibration  is  different  for  the  two  monitors  presently  being  used  by  KEO’s  cameras  HRP 
and  MIP.  HRP  presently  uses  an  NEC  3FGx,  and  MIP  presently  uses  ari  NTC  3D 
monitor.  Both  of  these  monitors  have  been  calibrated  at  VGA  resolution  (640x480)  but 
arc  capable  of  higher-resolutions.  If  higher-resolutions  are  desired,  then  new  calibrations 
should  be  carried  out.  When  initializing  the  MIPCTL  application,  the  monitor 
configuration  is  looked  at,  and  the  appropriate  translation  calibration  is  selected. 

The  calibrations  for  the  MIP  imager  using  the  NEC  3D  monitor  are; 


Zoom  Factor: 

xl 

X^  =  0.924856 

*  XvGA  -  7.745665 

Y  =  Y 

^  AfC  VGA 

Zoom  Factor: 

x2 

Xafg  =  0.462 174 

♦XvGA- 4.155732 

Y  =  Y 

Zoom  Factor: 

x4 

Xafg  =  0-231362 

*XvGA-  2.262211 

Y  =  Y 

Zoom  Factor: 

xl/2 

^AFG  ~  1.849 

*XvcA-  15.131 

Y  =  Y 

*  APC  *  VGA 
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The  calibrations  for  the  HRP  imager  using  the  NEC  3FGx  monitor  are: 


Zoom  Factor 

xl 

Xak:  =  0.94303  *XvGA-  3.5756 

^APO  “  ^VOA 

Zoom  Factor 

x2 

=  0.47131  *XvGA-  1-6803 

Yapo  =  Yyo^  /  2 

Zoom  Factor 

x4 

Xafg  =  0.23560  *  Xvga  -  0.8377 

^ATO  “  ^VOA  !  ^ 

Zoom  Factor 

xl/2 

Xafg  =  0.1.8846  •  Xvga  '  63846 

YyyPO  =  Yyg^  *  2 

These  calibrations  are  "hard-coded"  into  the  MIPCTL  application  and  have  been  tested  for 
consistency.  Because  of  the  limited  resolution,  there  will  be  times  when  the  translation 
between  Vga2AFG  or  AFG2Vga  wall  be  one  pixel  off. 

6.6  Commercial  Software  Installed  on  the  HAARP  Imager 

This  section  will  discuss  the  commercial  software  packages  installed  on  the  HAARP 
imager  as  delivered  with  this  contract: 

Qualitas  386Max  Version  7.0  Directory:  C:\386max 

386Max  is  a  DOS  memory  optimizer  that  restructures  the  DOS  memory  to  allow  more 
available  memory  space  for  applications  in  LO-MEMORY.  386Max  helps  programs  to 
run  quicker  due  to  less  memory  swapping,  especially  DOS  programs.  It  is  loaded  during 
the  boot-up  of  the  computer  and  it's  affects  are  transparent  to  the  user.  If  PIFs  need  to  be 
created  for  DOS  applications,  the  PIT  editor  from  Qualitas  prosndes  a  much  more 
powerful  tool  than  Windows  3.1  PIT  Editor. 

Installing  386Max  affects  CONFIG.SYS,  AUTOEXEC.BAT,  SYSTEM.INI  and 
WIN.INI. 

Berkeley  Systems  AfterPark  for  Window.s  2.0  Directory:  C:\afterdrk 

AfterDark  is  a  screen  s.iver  that  can  be  used  under  DOS  or  Windows  3.1.  It  is  loaded 
during  the  bootup  of  the  computer  and  can  be  reconfigured,  diasabled  and  enabled  via  the 
control  panel  which  is  accesed  from  the  minimized  AfterDark  icon  in  the  lower-left  hand 
comer  of  the  screen.  The  screen  sa\  cr  helps  save  the  monitor  from  bum  in. 
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Installing  AfterDark  affects  AUTOEXEC.BAT,  WIN.INI.  and  SYSTEM.INI. 

Nu-Meea  Bounds-Checker  1.00  Director>:  C^bchkw 

BoundS'Checker  for  Windows  is  a  debugging  tool  that  checks  your  application  for 
memoiy  leaks,  resource  allocation  problems,  and  Windows  API  parameter  violations.  An 
application  is  run  from  within  BCHKW  and  a  report  of  errors  and  other  system 
information  such  as  stack  space  and  memory  and  resource  usage  are  presented. 

Installing  Bounds*Checker  affects  SYSTEM.INI. 

Central  Point  Backup  for  Windows  v7.2  Directory:  C:Nq)backup 

Backup  for  Windows  is  a  backup  and  restore  utility  that  is  used  to  archive  the  program 
development  of  MIPCTL.EXE.  ITiis  utility  automates  the  backup  of  projects.  For 
HAARP  backups,  we  have  defined  the  HAARP-INC  and  HAARP-FU  backups  for  'full'  or 
'incremental'  backups.  More  extensive  backups  of  the  hard-disk  could  be  developed  using 
this  application. 

Installing  Backup  affects  SYSTEM.INI. 

Cybernetics  CYS45  Directory:  C:^cy543 

CY545  is  a  communications  DOS  utility  to  talk  to  a  CY545B  Stepper  Motor  Controller 
chip  (the  chip  that  is  used  to  control  the  Filter  WTieel  stepper  motor).  This  utility  is 
extremely  useful  for  adjusting  the  rate  parameters  and  rc-prograrruning  the  CY545's 
EEPROM.  For  more  information,  see  the  CY545  User's  Manual. 

Pinnacle  GSW  Graphics  Server  SDK  v2.Q  Directory:  C:\gsw 

GSW  is  a  DLL  that  is  used  for  plotting  and  charting  routines.  This  is  used  by  the 
MIPCTL  application  for  all  plotting  v/indows  and  is  crucial  to  the  execution  of  the 
plotting  features  of  MIPCTL.  The  Graphics  Server  GSW. EXE  is  launched  by  MIPCTL 
whenever  there  is  a  plot  window  opened.  This  server  appears  as  an  iconized  window  and 
handles  all  the  messages  and  drawing  of  the  plot  windows.  GSW  has  advanced  plotting 
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features  that  give  MIPCTL  and  the  programmer  for  HAARP  a  library  of  routines  that 
facilitate  the  development  of  plotting  applications. 

GSWDLL.DLL  and  GSW.EXE  are  installed  in  c:\windows.  GSW.H  is  installed  in 
c;\rosvcMnclude,  and  GSWDLL.LIB  is  installed  in  c:Nmsvc\lib. 

Lead  Technologies  LeadTools  DLL  v3.1  Diieaory:  C:MeaddU 

LeadToois  DLL  is  a  DLL  package  that  facilitates  handling  windows  with  images  using  all 
the  major  formats  such  as  bitmaps,  off,  fitts.  The  DLL  provides  window  zooming, 
scrolling,  rotation,  contrast,  brightness  as  well  as  archiving  and  restoring.  This  package 
was  to  be  used  to  develop  the  handling  of  HAARP  images  in  a  VGA  window  as  well  as  in 
the  AFG  video,  to  provide  more  features  and  capabilities.  Lead  Technologies  also 
provides  this  DLL  with  an  upgrade  that  includes  compression  capabilities. 

LEADDLL.DLL,  FIXED.DAT  and  FIXEDYUV.DAT  arc  installed  in  c:\windows. 
L^BITMAP.H,  L_ERROR.H,  and  L_TOOLAP.H  are  installed  in  c:Nmsvc\includc,  and 
LEADDLL.LIB  is  installed  in  c:Nmsvc\lib. 

Symantec  MultiScooe  Debugger  v2.0. 1  Directory:  C:Nmscope 

MuUiScope  Debugger  is  a  sophisticated  debugger  for  the  Windows  3.1  operating  system. 
It  replaces  CodeView  for  Windows  and  has  enhanced  capabilities.  MultiScopc  was  used 
to  debug  the  MIPCTL  application  before  the  installation  of  Microsoft  VISUAL  C/C+ 
which  has  it's  own  embedded  debugger.  WTiile  MSCOPE  is  much  more  powerful  than  the 
Visual  C  debugger,  it  was  found  not  to  be  necessary  for  most  purposes.  MSCOPE  has 
been  left  on  the  system  in  the  event  that  it  could  become  useful  for  fumre  applications.  It 
was  also  found  that  there  is  a  problem  running  MSCOPE  when  using  an  application  that 
uses  the  Graphics  Server  GSW.  Neither  company  could  find  a  reason  for  this 
incompatibility. 

Installing  MultiScope  Debugger  for  Windows  affects  the  SYSTEM.INI  file. 
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Directoiy:  C:\msvc 


Visual  C/C+-»-  is  Microsoft's  latest  C/C-m-  development  cnvironmeni  and  is  the  first  truly 
Windows  3.1  development  system  from  Microsoft.  The  MIPCTL  application  was  initially 
developed  using  Microsoft's  PWB  v6.0  and  then  PWB  v7.  Both  these  systems,  however, 
were  DOS  applications  and  were  not  very  good  and  have  been  deleted  fipom  HAARFs 
hard-drive.  Visual  OC-h-  has  been  found  to  be  a  much  easier  and  robust  development 
environment.  Microsoft's  C  development  environments  were  first  chosen  because  Imaging 
Technology's  ITEX-AFG  software  require  the  use  of  their  compilers.  ITEX-AFG  has 
now  evolved  to  the  point  of  being  a  Windows  DLL  and  is  not  conq^iler  dependent,  hence 
the  choice  of  development  environments  is  mote  flexible.  Symantec  and  Borland  also 
make  good  Windows  C  development  environments  (the  Acquistion  software  for 
MIPCTL  was  actually  developed  under  Borland).  Visual  C/C-h-  is  being  used  in  view  of 
the  historical  development  of  MIPCTL. 

Installing  Visual  C/C++  affects  AUTOEXEC.BAT  and  SYSTEM.INI. 

APT  ODESSA  vl.26  Directory:  C:\xlessa 

ODESSA  is  the  Magneto-Optical  Driver  for  the  RICOH  MO  I>rive.  The  actual  driver  is 
MOD.SYS  and  is  loaded  in  the  CONFIG.SYS  file.  There  are  several  utilities  such  as 
MOD.EXE  run  with  the  correct  switch  from  M.BAT  that  allows  formatting  and 
partitioning  of  MO  Disks,  FASTCOPY.EXE,  BFORMAT.EXE  and  HDD.EXE  which 
allow  fast  copying,  background  formatting,  and  SCSI  hard-drive  setup.  ODESSA  is 
necessary'  for  the  use  of  die  MO  drive.  Once  MOD.SYS  is  installed,  the  MO  Drive  is  used 
just  like  any  other  installed  drive  in  the  DOS/Windows  3. 1  operating  system. 

Installing  ODESSA  affects  CONFIG.SYS. 

Microsoft  Source  Profiler  Directory:  cNprofiler 

The  Source  Profiler  is  supplied  with  the  Microsoft  C  development  enviroment  to  check 
the  performance  of  a  C  application. 
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Imaping  Technology  ITEX-AFG  v2.2.2 


Directory:  cXvisnplus 


ITEX’AFG  is  the  core  to  programnung  with  the  AFG  Image-Processing  board  supplied 
with  the  HAARP  imager.  All  header  files,  link  libraries,  configuration  files,  debuggers, 
interpreters,  and  Dll.  executables  are  supplied  in  this  directory.  These  directories  are 
included  in  the  PATH  for  proper  develc^ment  In  addition,  the  TIGA  drivers  are  installed 
in  this  directory  for  communication  with  the  GSP34010  graphics  chip  on  the  AFG  board. 
An  Interpreter  (INTRP)  to  run  ITEX  commands  without  compilution  is  suppUed  with  this 
package  and  is  very  usefull  for  controlling  the  AFG  board  and  for  develcq)ing  new 
applications. 

Installing  ITEX-AFG  affects  AUTOEXEC.BAT. 

Microsoft  WEP  Directory  C:\wep 

WEP  is  a  collection  of  Windows  3.1  games  that  were  delivered  with  the  GATEWAYS 
2000  computer.  They  have  been  left  on  the  system  and  take  up  about  700K  of  disk  space, 
but  can  be  removed  if  desired. 

Microsoft  Windows  3.1  Directory  C:\windows 

Windows  3.1  is  the  operating  system  for  the  HAARP  image  processing  system. 
Familiarity  with  the  system  is  essential  for  productive  use  of  the  system.  The  software  is 
installed  on  the  HAARP  computer  in  the  default  configuration  and  has  been  optimized  for 
use  with  die  MIPCTL  application.  Windows  3.1  is  staned  automatically  on  booting  the 
computer  at  the  end  of  execution  of  AUTOEXEC.BAT.  If  this  is  not  desired, 
AUTOEXEC.BAT  can  be  modified. 

Installing  Windows  3.1  affects  AUTOEXEC.BAT,  and  creates  WIN.INI  and 
SYSTEM.INI. 

Delrina  WinFax  Pro  v3.0  Directory:  C:\winfax 

Winl’ax  Pro  is  a  Windows  3.1  program  to  allow  FAX  sending  and  receiving.  It  has  a 
complete  selection  of  cover  pages,  and  a  custom  cover  page  for  KEO  Consultants  has 
been  created.  In  addition,  the  PhoneBook  has  been  filled  with  useful  numbers  relevant  to 
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the  development  of  the  HAARP  camera,  WinFax  can  send  and  receive  faxes  in  the 
background,  thus  allowing  you  to  continue  your  work  in  the  foreground.  WinFax  is 
started  automatically  and  is  set  up  for  COM3  which  is  the  Gateways  TelePort 
Fax/Modem.  In  some  cases,  it  may  not  be  desired  to  always  have  WinFax  running.  In  this 
case,  just  close  the  application  using  the  minimized  WinFax  icon  in  the  lower  left-hand 
comer  of  the  screen. 

Installing  WinFax  Pro  affects  WIN.INI. 

Microsoft  Word  for  Windows  2.0  Directory  C:\winword 

Word  for  Windows  is  a  powerful  word-processor  program  and  is  used  for  all 
documenution  development.  Files  with  the  extension  .doc  are  typically  created  by  Word. 

Installing  Word  for  Windows  affects  WIN.INI. 

DCA  CrossTalk  for  Windows  v2.0  Directory  C:\xtalk20 

CrossTalk  for  Windows  is  a  Windows  3. 1  communications  program  and  is  setup  to  use 
the  GATEWAYS  TelePath  Fax/Modem  using  COM3.  This  program  is  useful  for 
electronic  communication  such  as  E-Mail  and  bulletin  boards  and  file- transfers  for  data, 
and  other  information.  Several  modem  configurations  are  already  setup  for  use  that 
contain  commonly  called  systems. 

Installing  CrossTalk  for  Windows  affects  WIN.INI. 

6.7  MIPCTL  Programming  Structures 

This  section  discusses  the  programming  structures  used  for  creating  the  MIPCTL 
application,  and  is  a  usefull  reference  for  programmers  interested  in  learning  more  about 
the  software  that  runs  the  HAARP  imager.  This  section  can  be  ignored  otherwise! 

6.7.1  General  Area  of  Interest:  GAOI 

GAOISTRUCT  is  used  to  access  G.^OI’s  on  the  AFG  board  that  are  predefined  by  tiie 
MIPCTL  program.  Using  the  GAOI  structures  discussed  in  Section  4.3.2,  three  variables 
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(nQuad,  nimage,  nDepth)  hold  the  GAOI  information  while  nlndex  is  tlic  actual  pointer 
in  the  AFG  GAOI  table  used  when  communicating  with  the  AFG  board.  (D^ned  in 
MIPCLBLS.H) 

typedef  struct 

{ 

short  nlndex;  //  Index  into  AFG  GAOI  Table 

int  nQuad;  //  Quadrant  in  Frame  Buffer 

int  rJmage;  //  Image  in  Quadrant 

int  nDepth;  //  Image  Depth 

)  GAOISTRUCT; 


6.7.2  Image  Structxire:  IMAGESTRUCT 

IMAGESTRUCT  is  the  main  structure  used  for  any  image  stored  in  the  AFG  frame  buffer. 
Ihis  structure  contains  pointers  to  the  GAOI,  the  Image  Overlay  Window,  and  Image 
Overlay  List,  ROI,  and  the  Image  Information  structure.  MIPCTL  creates  a  table  of 
these  structures  that  correspond  to  the  predefined  images  discussed  in  Section  4.3.2. 
(Darned  in  MIPCLBLS.H) 


typedef  struct 
Structure 
{ 

HWND  hWndOwner, 
HWND  hlooWnd; 
short  nGaoi; 

HIOO  hloo; 

HIMINFO  himinfo; 

RECr  rROI; 

WORD  flags; 

)  IMAGESTRUCT,  *plmage; 


//  IMAGESTRUCf;  Image 

//  Handle  to  the  parent  window 
//  Handle  to  the  loo  window 
//  ioo  GAOI 

//  Handle  to  the  image  object  list 
//  Handle  to  the  image  info  header 
H  Rectangle  for  ROI 
//Flags  for  looWnd 
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6.7.3  Plot  Window  Structure:  PLOTTNFO 


The  PLXDTINFO  structure  is  used  to  hold  all  the  information  necessary  to  create  and 
maintain  a  plot  window.  Plot  windows  record  the  plotinfo  index  number  in  theu*  window 
words  to  access  this  structure.  The  PLOTINFO  structure  for  the  plot  window  is  filled 
when  the  plot  data  is  first  read  from  the  AFG  frame  buffer.  (Defined  in  MIPGLBLS.H) 

struct  plot  { 


int 

type; 

//  Plot  type;  PROW,  PCOL,  PARE,  PHIST,  PHIST_ROI 

short 

nGaoi; 

//  GAOI  data  was  taken  from 

DWORD 

rgbClr, 

//  RGB  color  of  plot 

int 

color. 

//  Plot  color  for  AFG  board  drawing 

POINT 

begPoint; 

//  Beginning  point  of  plot  IN  GLOBAL  UNITS 

POINT 

endPoint; 

//  Ending  point  of  plot  IN  GLOBAL  UNITS 

long 

numPoints; 

//  Number  of  points  in  the  plot 

HANDLE 

hPlot_Data; 

//  handle  to  plot  data 

HANDLE 

hWnd_Data; 

//  handle  to  window  data 

HANTjLE 

hloo; 

//  handle  to  the  loo  for  the  plot 

HIMINFO 

himinfo; 

//  Handle  to  the  image  info  header 

)  plodnfofNUM.  PLOTS.MAXl; 


6.7.4  Image  Information  Structure;  IMINFOSTRUCT 


The  IMINFOSTRUCT  is  used  to  hold  all  the  pertinent  instrument  information  that  was 
used  for  the  image  to  which  the  structure  is  linked.  This  information  is  used  to  create  the 
image  information  header  that  is  written  into  the  image  file  when  saved  to  disk  and  when 
image  labelling  operations  are  executed.  (Defined  in  MIPGLBLS.H) 


typedef  struct  { 

long  llmageTune; 

int  nlntGain; 

unsigned  int  nExpTime; 
char  S2filtcrVal[9); 

int  nCCDTemp; 

int  nTECTemp; 


//  Pointer  to  a  lime  structure  (  4  Bytes 

//  Image  Intensifier  Gain 

( 2  Bytes 

//  Exposure  Time 

( 2  Bytes 

//  Filter  Position 

( 9  Bytes 

//  CCD  Temperature 

(  2  Bytes 

//  TEC  Temperature 

( 2  Bytes 

) 

) 

) 

) 

) 

) 
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int 

nIntTcmp; 

//  Intensifier  Temperature 

( 2  Bytes 

) 

int 

nFiltTemp; 

//  Filter  Wheel  Temperature  ( 2  Bytes 

) 

int 

nlntBit; 

//  Intensifier  Brightness 

( 2  Bytes 

) 

short 

nFOV; 

//Field  of  View 

( 2  Bytes 

) 

char 

*pLocation; 

//Location 

( 2  Bytes 

) 

char 

♦pCwnment; 

//  Comment 

( 2  Bytes 

) 

short 

nCaoi; 

//GAOI  holding  the  image  ( 2  Bytes 

) 

)  IMINFOSTRUCT; 

6.7^  Image  Overlay  Object  Structure;  loo 

Tbe  loo  Structure  is  a  linked-list  structure  that  holds  the  Image  Overlay  Object 
information  necessary  to  maintain  an  object  in  the  Image  Overlay  Window.  Image 
Overlay  Objects  can  be  text  labels,  lines,  cross-hairs,  boxes  --  any  graphics  object  that  is 
overlayed  on  the  image.  (Dtfined  in  100. H) 

typedef  struct  _Ioo  { 


IOO_ID 

id; 

//  Object  Type 

HIMAGE  hOwner, 

//  Image  that  owns  the  object 

HIOO 

hNext; 

//  Next  loo  in  the  list 

HIOO 

hPrev; 

//  Previous  loo  in  the  list 

WORD 

flags; 

//  loo  drawing  flags 

char 

dau[]; 

//  loo  data  (Object  specific) 

)  loo,  far 

*pIoc; 

6.7.6  Acquisition  Entry  Information  Structure:  aqENTRYlNFO 

aqENTRYlNFO  keeps  the  information  necessary  to  act  on  tiie  currently  selected  entry  in 
the  acquisition  table.  (Defined  in  AQENTRY.H) 

typedef  struct  { 

aqENTRY  e;  //  acquisition  Entry  infoimation 

aqTABLEENTRY  *inTable;  //  pointer  to  entry  in  acquistion  table 

int  inLisiBox;  //  entry  number  in  List  Box 

)  aqENTRYlNFO 
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6.7.7  Acquisition  Table  Entry  Structure:  aqTABLEENTRY 

The  aqTABLEENTRY  structure  creates  a  linked-list  of  acquisition  entries.  (Defined  in 
AQTTABLE.H) 

typedef  struct  aqTE  { 
struct  aqTE  *next; 
struct  aqTE  *prev; 
aqENTKY  e; 

}  aqTABLEENTRY 

6.7.8  Equipment  Structure:  aqEQUIPMENT 

The  aqEQUIPMENT  structure  is  used  to  keep  track  of  equipment  settings  in  the 
instrument  such  as  which  filter  is  in  a  certain  filter  wheel  slot.  (Defined  in  AQUIS.H) 


/'/  Next  table-entry  in  list 
//  Last  table-entry  in  list 
//  Current  table-entry 


typedef  struct  { 

int  nDlgltemlD:  //  Item  ID 

char  text[AQ_MAXLABELl;  // String  identifying  equipment 

}  aqEQUIPMENT[AQ_NUMEQUIPSTRINGS); 

6.7.9  Acquisition  Entry  Structure:  aqENTRY 

The  aqENTRY  holds  all  the  inforraadon  necessary  to  execute  one  event  in  the  acquisition 
table.  For  a  typical  acquisition  event,  parameters  such  as  Gaoi,  Intensifier  Gain,  Exposure 
are  recorded.  These  parameters  can  also  be  used  for  different  things,  such  as  a  math 
operation,  where  the  parameter  nExposure  has  a  much  different  meaning.  The  parameter 
nFilter  is  used  to  record  which  filter  is  to  be  u*^  J  in  a  data  acquisition  event  and  can  have 
the  values  1  through  5  for  this  purpose.  If  this  parameter  is  less  than  zero,  it  flags  an 
alternative  type  of  acquisition  event  identified  by  it's  absolute  value.  For  example,  if 
nFilter  is  set  to  -6,  this  flags  that  the  event  is  a  PAUSE,  and  the  next  parameter 
nGaoiLoc  is  checked  to  get  the  pause  duration.  (Defined  in  AQUIS.H) 
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typedef  struct  { 
int  nFiltcr, 

int  nGaoiLoc, 

int  nlntensifier, 

int  nDisplayMin; 

int  nDisplayMax; 

int  bRecoid; 

BOOL  bDarkSubtract; 

}  aqENTRY; 

6.7.10  Acquisidur.  Desktop  Structure:  aqDESKTOP 

The  aqDESKTOP  structure  holds  the  present  path  and  filenames  for  the  acquisition 
information.  Acquistion  tables  are  stored  in  files  with  the  extension  •.AQT.  MIPCTL 
keeps  track  of  which  acquisition  table  was  last  opened  using  this  structure.  (D^ined  in 
•  QUIS.H) 

typedef  struct  { 

char  S4Pa»h(PATHLEN]; 
char  szTable(FILENAMELEN]; 
char  Si£quip[FILENAM£LEN]; 

)  aqDESKTOP; 

6.8  Adding  New  Operations  to  the  Acquisition  Cyclt. 

The  acquisition  cycle  can  now  accomnxxiate  an  arbitrary  number  of  operations  during  an 
acquisition  period  in  addition  to  the  normal  acquisition  event.  'Hie  presently  defined 
operations  for  tlie  acquisition  cycle  for  MIPCTL  v5.3  are  as  follows: 

Acquisition: 

Setup  camera  ->  acquire  image  ->  reccrd(flag)  ->  label  ->  rescale 
Math: 

Additior,  subtraction,  multiplication  ol  two  images  using  the 

AFG  hard  ware  ALU. 


Snap: 

Snap  one  image  to  another  with  the  option  of  scaling  image. 

Pause: 

Pause  for  a  specified  amount  of  time. 

Loop: 

Loop  back  n  entries  iu  the  acquisition  table  j  tir'es. 

There  can  be  any  number  of  operations  that  the  usei  naay  want  incorporated  into  the 
acquisition  cycle.  These  are  now  very  easy  to  add,  but  there  are  many  steps  necessary  to 
accomplish  this.  To  facilitate  this,  follow  this  procedure: 

(1)  Dialog  Box:  There  must  be  some  dialog  box  associated  with  setting  up  the 
parameters  of  the  op^tions.  First  aeatc  this  dialog  box  defining  the  controls  and  dialog 
name: 


Define:  NewOp.res  NewOp.dlg  Ne'’'Op.h 

NEWOPBOX  (Dialog  Box  Ncne) 

IL)C_  (List  of  controls  in  dialog  box) 


In  MIPCTL.H,  add: 


(2)  Add  the  dialog  files  to  MIPCTL.H 

#inrlude  NewOp.h 

BOOL  FAR  aqNcwOpEntryD!g(  ...) 

#definc  IDM_NEWOP 


to  the  list  of  dialog  headers 
to  the  list  of  dialog  function  declarations, 
to  the  list  of  menu  identifiers  for  the  SETUP 
menu. 


(3;  Add  the  dialog  resource  ar.d  menuID  to  MIPCTL.RC: 

Under  tl’c  SETJPMENU,  add; 

r  EhfUlTEM  '  &NcwC)p",  IDM„NEWOP 

Under  the  list  of  rrii.cludes,  add; 
rcinclude  NEWOP.DLG 
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(4)  Create  the  dialog  function  aqNewOpEntryDIg:  Write  the  framework  for  the 
dialog  function  to  be  used  when  the  dialog  box  is  open.  This  sets  up  the  input  parameters 
for  the  acquisition  table.  This  function  can  be  added  to  AQIMGMTH.C  or  put  in  a  new 
source  file.  If  a  new  source  file  is  used,  be  sure  to  add  this  to  the  MAKEfile.  In  addition, 
this  new  dialog  function  must  be  added  to  the  list  of  callback  functions  in  the  defi.ntinion 
file:  MBPCTL.DEF.  For  examples  of  doing  both  of  these  things,  sec  oqLoopEntryDlg. 
Notice  how  every  operation  dialog  fiinction  makes  hMathDlg  equal  the  handle  to  the 
operation's  dialog  in  the  WM_INnT)IALOG  message,  and  sets  hMathDlg  to  NULL  when 
the  operation  gets  a  WM_DESTROY  message.  The  name  hMathDlg  is  an  unfortunate 
naming  left  over  from  when  the  only  operations  were  math  operations,  and  should  be 
renamed  to  hOpDlg  in  a  future  version  of  this  software. 

(5)  Define  the  command  identifier:  In  AQUIS.H,  add  a  new  identier  for  the  NewOp 
command.  All  operation  identifien  must  have  a  negative  value.  A  zero  value  is  a  null 
entry,  and  any  positive  value  for  the  identifier  is  assumed  to  be  an  image  acquisition  and 
the  identifier  is  taken  as  the  filter  value.  See  for  example: 

^define  EN_LOOP  -7 

(6)  Add  dialog  function  declaration  to  AQSETUP  C  and  AQRUN.C:  Add  the 
function  declarations  for  aqNewOpEntryDlg  to  the  top  of  these  two  files.  Again,  for 
example,  see: 


BOOL  FAR  aqLoopEntryDlg(  HWND,  WORD, .... ); 

(7)  Define  the  operation  entry  variables:  An  acquisition  entry  has  the  structure 
aqENTRY  shown  below.  The  variable  names  represent  what  these  values  are  during  an 
image  acquisition,  but  for  operations,  these  values  can  take  on  tlietr  own  meanings. 


agENTRYLSiruriure  Pgfinilipn 


typedef  struct 

{ 


int 

int 


nFilter, 

nGaoiLoc; 
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int  nintensifier, 

int  nDisplayMin; 

int  nDisplayMax; 

int  bRecoid; 

BOOL  bDarkSubtract; 

) 

aqENTRY; 

The  only  requirement  is  that  enFilter  hold  the  operation  identifier  EN_NEWOP  which 
must  be  less  than  zero  to  not  be  interpreted  as  an  image  acquisition  event.  In  the  LOOP 
example  above,  the  following  definitions  were  made. 

nFilter=  EN_LOOP 

nGaoiLoc  =  The  number  of  entries  to  loop  back  to. 

nbxposure  =  The  number  of  times  to  execute  the  loop. 

All  other  entries  arc  ignored. 

(8)  Code  up  the  dialog  function  aqNewOpEntryDIg:  Write  the  code  that  haiKlles  the 
dialog  function  messages  and  sets  up  the  current  entry  with  the  correct  parameters  defined 
in  (7)  for  the  NewOp  operation.  See  oqLoopEntryDlg  in  AQIMGMTH.C  for  an 
example. 

(9)  Add  the  menu  option  IDM_NEWOP  to  SetupWndProc  in  AQSETUP.C:  Rnd 

IDM_LOOP  and  copy  this  code,  changing  LOOP  to  NEWOP  wherever  appropriate.  This 
function  opens  the  dialog  box  NEWOPBOX,  when  the  menu  item  is  selected.  After  the 
dialog  function  is  completed,  the  new  entry  is  added  appropriate  to  the  acquisition  table. 
Once  added,  this  entry  is  treated  as  any  other  entry  as  so  all  other  code  is  identical. 

(10)  Add  the  EN_NEWOP  case  to  ’entryZstr’  in  AQSETUP.C:  The  function 
entrylstr  coii  verts  the  acquisiton  table  entry  passed  into  a  character  string  to  be  added  to 
the  listbox  in  the  TableDlg.  This  string  should  be  some  English  oriented  representation  of 
the  operation  to  be  acted  on.  For  example,  in  the  EN_LOOP  case,  the  string  returned  is: 


LOOP  back  3  entric'  5  times 


assuming  nHlter  =  EN_LOOP,  nGaoiLoc  =  3,  and  nExposure  =  5. 


(Jl)  Add  EN_NEWOP  to  the  EntryDIgProc  in  AQENTRY.C:  The  EntiyDlgProc 
must  be  able  to  handle  creating  the  operation  dialog  functions  as  well  Look  for  the 
switch  case  that  looks  like; 

switch  ( aqCurEntry.nFiltcr ) 

{ 

case  EN_ADD; 

.  break; 

case  EN_LOOP: 

.  break; 

)  Etc.,  etc. 


Add  the  case  for  EN_NEWOP. 

(12)  Create  the  DoNewOpEiitryO  function  in  AQRUN.C:  This  is  the  function  that 
actually  does  the  operation  during  the  running  of  the  acquisition  table.  Thi.s  function 
retrieves  the  operation  parameters  finom  the  current  aqEniry  (tp->c)  and  does  the 
operation  based  on  these  parameters.  For  example,  sec: 

DoMarhEntryO,  DoLoopHntryO,  DoPauscEntry(). 

Notice  how  the  return  values  BEGIN  and  SDONE  arc  diffc  ently  in  the  opcradoris. 

(13)  Add  the  operation  to  the  BEGLS  ca*^-  in  AQRUN.C:  When  the  table  is  running, 
the  BEGIN  step  is  the  first  step  nn  during  an  entry  sequence,  (see  function 
'nextStepInScqucnce')  If  the  entry  is  an  operation  (  tp  >c.nFiUer  <  0  ),  then  the 
appropriate  DoNewOpEntryO  function  that  was  written  m  (12)  must  be  called.  This  case 
must  be  added  to  the  switch  case  here.  Roughly: 

case  BEGIN  : 

if  ( tp->e.nFilter  <  0  )  /,'  Is  it  an  operation'’ 

{ 

switch  ( tp->e.nFilici  ) 
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case  EN_ADD  : 

DoMaihEntryO; 

break; 

case  El'I_LOOP : 

return  DoLoppEntry(); 
case  FA’_NEV/OP : 

DoNewOpEntryO;  //  New  operation 
bieak; 


) 

These  are  all  the  steps  necessary  for  adding  a  new  operation.  A  full  REBUILD  must  be 
done  before  testing  out  the  new  code,  as  the  global  header  file  MIPCTL  was  changed 
which  affect  the  state  of  the  pre-compiled  header. 

6.9  Image  Comment  Chronological  Definitions 

6.9.1  MIPCTL  v2.0;  7/10/92  (CRRES  Campaign) 


szImageCommeni(0]  =  0; 


//  Initialize  the  string 


tpinfo  =  imageInfoHclr(nHdrID).tpImagcTimc; 
strfiime<  temp,  20,  "%d  %b  %y",  tpinfo  ); 
strcpy(  szImageComment,  temp ); 
strcat(  szImageComment, " " ); 
strftime(  temp,  20,  "%X",  tpinfo ); 
strcat(  szImageComment,  temp ); 


//Get  time  structure 
//  Convert  Date  to  suing 
//copy  to  image  comment 
//  add  a  space  to  comment 
//  Convert  Time  to  suing 
//  copy  to  image  comment 


sprinti(  temp, 

"  G[% ld)W(%8,s]E[%3dI V(%3d)C(%3d)TI%3d)I(%3d)F(%3d]B(%3dJ . %30s  %80s”, 

imagcInfoHdr(nHdrID).nIntGain. 

imagcInfoHdr(nHdrID).szFilterVal, 

imagcInfoHdrjnHdrlDJ.nExpTimc, 

imagcInfoHdr(nHdrID].nFOV, 
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imageInfoHdr(nHdrID).cCCCTemp, 

iniagelnfoHdfInHdrID].cTECTcmp, 

iniageInfoH(lr{nHdrID].cIntTeinp. 

ijnageInfoHdr(nHdrID].cFUtTemp, 

iniag<'InfoH(lrinHdrID].clntBrt2, 

szLocation,  szComment  ); 


strcat(  szlmageCommenu  tsmp ); 
6.9.2  MIPCrLv4.0.3:  11/19/92 


szlmage  Comment[0]  =  0;  //  Initialize  the  string 

//  Write  KEO  Identifier  into  the  header  and  get  software  version... 
strcpy(  szImageComment.  "KEO" ); 
sscanf(  S2 Version,  "Version:  %s".  temp ); 
stmcat(  szImageComment,  temp.  3  ); 
strcatf  szImageComment,  “ " ); 
stnicat(  SzImageComment,  szCamera,  3  ); 
stTcatf  szImageComment, ); 


//  Write  the  Date  and  Time  from  the  timestamp  into  the  comment... 
tpTime  =  localtime<  &(pINF->IIniageTime) );  //  Convert  to  local  time 


strftime(  temp,  20,  "%d  %b  %y',  tpTime ); 
strcat(  szImageComment.  temp ); 
strcat(  szImageComment, "  ” ); 


//  Convert  Dale  to  string 
//copy  to  image  commcnl 
//  add  a  space  to  comment 


3trftiine(  temp.  20,  "%X",  tpTime  );  //  Convert  Time  to  string 

strcat(  szImageComment,  temp );  //copy  to  image  comment 


sprintf(  temp. "  G(%ld]W(%8s)E[%3dj  V(%3d]Cl%3d)TI%3d]I(%3d]F[%3(l]B[%3d]-%30s  %80s". 

pINF->nIntGain, 

pINF->szFiltcrVal, 

plNF->nExpTime, 

pINF->nFOV, 

pIMF->nCCDTemp, 
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pINF->nTECTcmp, 

plNF->nfniTemp, 

pINF->nFiliTcnip, 

pINF->nIniBn, 

pINF->pLocaiion,  pINF->pComnieni ): 

strcat(  szImageComment,  temp  ); 

6.9.3  MIPCTL  v4. 1 .0:  1 1/20/92 

szitnage  CommentfO]  =  0;  //  Initialize  the  suing 

//  Write  KEO  Identifier  into  the  header  and  get  software  version... 
strq)y(  szImageComment,  "KEO" ); 
sscanf(  sz Version,  "Version:  %s".  temp ); 
smicat(  szImageComment,  temp,  3 ); 
strcaiC  szImageComment, " " 
stmcat(  szImageComment,  szCamcra,  3 ); 
strcat(  szImageComment, ): 

//  Write  the  Date  and  Time  from  the  timestamp  into  the  comment... 

tpTime  =  localtime(  &(pINF->lImagcTimc) );  //  Convert  to  local  lime 

strftimef  temp,  20,  "%d  %b  %y".  tpTime );  //  Convert  Date  to  string 

strcat(  szImageComment,  temp );  //  copy  to  image  comment 

strcat(  szImageComment, " " );  //  add  a  space  to  comment 

strfiimef  temp,  20,  "%X",  tpTime  ),  //Convert  Time  to  suing 

sucat(  szImageComment,  temp ),  //  copy  to  image  comment 

sprintf(  temp, "  G(?old)W[%8s]E(%3d)V(%3d)C(%3dJT(%3d)I(%3d]F[%3d]B(%3d]-XXXX-%30s  %75s", 

pINF->nIniGain, 

pINF->szFiUcrVal, 

plNF->nExpTimc, 

pINF->nFOV, 

plMF->nCCDTcmp, 

pINF->nTECTcmp, 


pINF->nIntTemp, 

pINF->nFiUTemp, 

plNF->nIntBn, 

pINF->pLocauoii,  pINF->pCominent ); 


scrcai(  szImageComment,  temp ); 

long  *pTimc;  //  Pointer  to  a  lime  variable 

pTime  =  (long  •)(szlmageComment  +  88); 

•pTin^.c  y  pINF->llmageTime;  //  Put  time_t  into  the  header... 

szliTtageComment[199]  =  0;  //Terminate  just  to  be  safe... 

6.9.4  MIPCTLv4.2.1:  12/31/92 

//  Build  ImageTechnology  image  header:  200  Bytes  long... 

szInfofO]  =  0;  //  Initialize  the  string 

//  Write  KEO  Identifier  into  the  header  and  get  software  version... 
strcpy(  szlnfo,  'KEO" ); 
sscanf(  sz Version.  '  Version:  %s''.  temp ); 
stmcat(  szlnfo.  temp.  3  ): 
strcat(  szlnfo. " " ); 

.stmeaK  szlnfo.  szCamcra,  3  ); 
strcat(  szlnfo, ); 


//Write  the  Date  and  Time  from  the  time-.slamp  into  the  comment... 
tpTime  =  !ocaItimc<  &(pINF-?iImage7  ime) );  //  Convert  to  local  lime 


strftime(  temp.  20,  ''%d  %b  %y",  tpTime  ); 
strcaif  szlnfo,  temp ); 
strcai(  szlnfo, " " ); 


//  Convert  Date  to  suing 
//  copy  to  image  comment 
//  add  a  space  to  comment 


suftimef  temp,  20,  "%X",  tpTimo  ); 
suca'(  szlnfo,  temp ); 


//Convert  Time  to  string 
//copy  to  image  comment 
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//  Build  the  info  siring:  -XXXX-  =  ITime  (4  Bytes) 
sprintf(  temp, 

■G[%ld]W(%8s]E[«i3d]V(%3d)C{%3dlT(%3d]I(%3d)Fl%3d]Bt%3d]-XXXX-%ld-%ld-%26s  %75s", 
plNF->nIntGain, 
pINF->szFilierVal, 
pINF->nExpTime, 
pINF->nFOV, 
pINF->nCCDTemp. 
plNF->nTECTemp, 
pINF->nlntTcmp, 
pINF->nFiltTemp, 
plNF->nIniBn. 
nCGain,  nCBin, 

plNF->pLocation.  pINF->pCommcni ); 
strcai(  szinfo,  temp }; 

//  Put  binary  information  into  the  header... 
pTime  =  (long  ‘Xsalnfo  +  HDR_T1ME);  //Time  (4  Bytes) 

*pTime  =  pINF->lImageTime; 

szInfo(199]  =  0;  // Terminate  just  to  be  safe! 
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6.9.5  MIPCTL  V4.2.2:  1/3/93 


Header  Change:  Put  the  binary  time  at  the  end  of  comment  in  the  event  of  a  0  byte 


// Defines  for  header  offsets:  Updated  1/3/92  V4.2.2 

..define  HDR.GAIN  30 

^define  HDR.TIME  194 

#define  HDR.CGAIN  88 

#definc  HDR.CBIN  90 

#define  HDR_LOCTN  92 

#define  HDR.COMMNT  119 

#definc  HDR_LOC_LEN  26 

Wefine  HDR_COM_L£N  75 

//  Build  ImageTechnology  image  header:  200  Bytes  long... 

szlnfo[0]  =  0;  //  Initialize  the  siring 

//Write  KEO  Identifier  into  the  header  and  get  software  version... 

strcpy(  szlnfo,  "KEO" ); 

sscanf(  szVersion,  "Version;  %s",  temp  ); 

stmcai(  szlnfo.  temp,  3  ); 

strcat(  szlnfo, " " ); 

stmeatf  szlnfo,  szCamcra,  3  ); 

strcat(  .szlnfo, ); 

//  Write  the  Date  and  Time  fiom  the  time-stamp  into  the  comment... 


I  tpTirne  =  iocaliimc(  &(pINF'->IIma£cTimc) );  //  Conven  to  local  time 

I 


sirflime(  temp,  20,  "%d  %b  %y'',  ipTimc ); 
strcat(  szlnfo,  temp); 

$ucat(  szlnfo. " " ); 


//Convert  Date  to  string 
//  copy  to  image  comment 
//  add  a  space  to  comment 


strftirnc(  temp,  20,  "%X",  tpTime  ). 


//  Convert  Time  to  string 
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sm;at(  szinfo,  cemp ); 


//  copy  to  image  comment 


//  Build  the  info  string:  -XXXX-G-B-  XXXX  =  ITime  (4  Bytes),  G  =  nCGain  (1  Byte),  B  =  nCBin  (I 
Byte) 

sprintf(  temp. 

■G[%ldJW(%8s]Et%3d)V(%3d]C(%3d)T[%3d]I(%3d)Fl%3d)B[%3dJ-%ld-%ld-%26s  %75s-XXXX", 
pINF'>nIntGain, 
pINF->szFilierVa!, 
pINF->nExpTimc, 

FlNF.>nFOV, 

pINF->nCCDTemp, 

pINF->nTECTeinp, 

pINF'>nIntTemp, 

pINF->nFiltTeinp, 

pINF->nIntBrt. 

nCGain,  nCBin,  //Global  variables 

pINF->pLocation,  plNF->pCoinmcnt ); 


strcaU  szinfo,  temp ); 

//  Put  binary  information  into  the  header... 

pTime  =  .'long  •)(szInfo  +  HDR..TIME);  //  Time  (4  Bytes) 

•pTimc  =  plNF->lImageTime; 

szinfol  199]  r.  0;  //  Terminate  just  to  be  safe! 


6,9.6  MIPCTL  V5.3.0:  7/16/93 

Header  Change:  Encodes  the  binary  time  to  make  sure  there  are  no  zero  bytes  in  the 
time  information  that  would  act  as  a  termination  character.  Time  is  now  written  and 
extracted  from  the  informatio.n  header  using  the  functions  (defined  in  MIPFINFO.C): 

MakeTimeString(  long  *pTimc,char  *szString  ); 
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ITime  =  GetTimeFromStringC  szInfoHdr  +  HDR_TIME ); 

The  time  string  is  now  5  bytes  long.  The  first  being  a  status  byte  defined  as: 

0  1  1  1  SB3  SB2  SBl  SBO 

where  SBO  — >  SB3  are  define  as  1  if  the  corresponding  byte  i:  non-zero  and  0  if  the 
corresponding  byte  is  zero.  If  a  byte  in  the  Gong)  ITune  is  zero,  this  is  changed  into  a 
0x7F.  So  the  time  string  looks  like: 

SB  BO  B!  B2  B3. 

Two  examples; 

0x01020304  — 7F  04  03  02  01 

0x01020004  -— >  7D  04  7F  02  01 

Header  definitions  (same  as  4.2.2): 

#derine  HDR_GA1N  30 
#derine  HDR_TIME  194 
#define  HDR_CGAIN  88 
#derincHDR_CBIN  90 
#define  HDR, LOGIN  92 
#define  HDR_COMMNT  119 
#define  HDR_LOC_LEN  26 
Mefine  HDR_C0M_LEN  75 


178 


//  Build  ImageTechnology  image  header;  200  Bytes  long... 


szlnfo[0]  =  0;  //  Initialize  the  string 

//  Write  KEO  Identifier  into  the  header  and  get  software  version.^ 

strcpy(  szinfo,  "KEO" ); 

sscanf(  sz Version,  "Version:  %s",  szComment ); 

stmcat(  szinfo.  szComment,  3  ); 

streatf  szinfo, "  " 

stmcat(  szinfo,  szCamera,  3  ); 

streaK  szinfo, ); 


//  Write  the  Date  and  Time  from  the  time-stamp  into  the  comment... 


tpTime  =  localtimef  &(pINF->nmagcTime) ); 


//  Convert  to  local  time 


strftime(  szComment,  20,  "%d  %y",  tpTime ), 

strcat(  szinfo,  szComment ); 
sticat(  szinfo, " " ); 


//  Convert  Date  to  string 
//  copy  to  image  comment 
//  add  a  space  to  comment 


strftime(  szComment,  20,  "%X",  tpTime );  //Convert  Time  to  string 

strcat(  szinfo,  szComment );  //  copy  to  image  comment 


//  Build  the  info  string: 


sprintf(  szComment, 

"G(%ld]W[%8s]E[%3d]V[%3d]C[%3dlT(%3d]l(%3djF[%3d)B[%3d]-%ld-%ld-%26s%75s- 

XXXX", 

pINF->nlnlGain, 

pINF->szFillcrVaJ, 

plNF->nExpTimc, 

plNF->iiFOV, 

pINF->nCCDTemp, 

plNF->nTECTcmp, 
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plNF->nIniTemp, 
pINF->nFiItTcnip, 
pINF->nIniBrt, 
nCGain,  nCBin, 

pINF->pLocauon,  pINF->pComtnent ); 
sircat(  szinfo,  szComment ); 

//Pul  binary  information  into  the  header... 

MakeTimeStringf  &(pINF->lImageTime).  szTimc );  //  Create  the  lime  string  (char  szTmie[6]) 

pChar  =  szinfo  +  HDR_TIME; 
sU7icpy(  pChar,  szTime,  5  ); 

szlnfo[199]  =  0; 


//  Point  to  the  time  string  position 
//  Copy  time  string  into  corament 

//  Terminate  just  to  be  safe! 
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Chapter  7  FORTH  and  DSP  Programming 

7.1  Introduction 

Tfte  heart  of  the  HAARP  camera  control  system  is  the  Controller  board  supplied 
by  Advanced  Technologies.  This  board  has  on-board  memory  with  the  embedded 
program  that  controls  all  the  hardware  in  the  camera.  There  are  two  processors  on  this 
board:  the  68HC1 1  micorprocessor,  and  the  DSP56(X)1  digirial  signal  processor.  For  a 
more  in-depth  understanding  of  the  hardware,  the  user  can  study  the  supplied  schematics, 
software  listings,  and  the  manuals  for  the  68HC11  and  the  DSP56001.  These  two 
processors  have  two  distinct  responsibilities. 

The  68HC11  is  the  main  'brain'  of  the  camera  system.  It  controls  all 
communication  to  the  outside  world  via  it's  RS-422  port.  It  stores  all  the  command 
structure  to  control  the  hardware  aspects  of  the  camera  from  the  KEO  control  systems 
such  as  filter  wheel,  temperature  readout,  intensifier  gain  and  shutters,  to  camera  control 
systems  such  as  CCD  read,  clear,  bias.  The  68HC1 1  is  programmed  in  FORTH  and  has 
an  embedded  FORTH  system  burnt  into  it's  internal  ROM.  In  addition  there  is  an  external 
EEPROM  which  permanently  stores  the  user  FORTH  dictionary  and  an  external  RAM  for 
operation.  During  bootup,  the  contents  of  the  EEPROM  are  loaded  into  RAM.  This 
section  discusses  the  FORTH  program  burned  into  EEPROM. 

The  DSP56001  is  a  dedicated  processor  to  provide  the  actual  clocking  and  timing 
signals  required  by  the  CCD.  It  is  used  as  a  state-machine  to  quickly  clock  through  all  the 
different  states  that  the  CCD  needs.  The  DSP  code  is  written  in  56000  Assembler  and 
stored  in  the  EEPROM  of  the  68HC1 1  as  binary  executable  code.  At  bootup,  the  68HC1 1 
downloads  this  code  to  the  DSP  RAM  and  tests  the  DSP's  functionality. 

The  68HC1 1  on  the  Advanced  Technologies  Control  Board  is  supplied  by 

New  Micros,  Inc. 

1601  Chalk  HUl  Rd. 

Dallas,  Texas  75212 

(214)339-2204 
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At  power-up,  an  auto-start  routine  loads  the  dictionary  from  the  EEPROM  to  RAM,  loads 
the  DSP  code  into  the  DSP  RAM,  initializes  the  DSP  chip  and  HAARP/CCD  electronics, 
and  starts  the  HAARP  command  loop.  The  HAARP  command  loop  restricts  the  input  to 
the  camera  and  hence  protects  the  FORTH  system  from  causing  catastrophic  failures  due 
to  operational  errors.  The  HAARP  can  also  be  operated  as  any  FORTH  system  by  exiting 
out  of  this  command  loop.  At  this  point,  the  user  can  use  any  of  the  presently  defined 
words  in  the  FORTH  dictionary  as  well  as  control  all  aspects  of  the  MIP  camera,  add  new 
words,  and  store  a  new  dictionary  in  the  EEPROM.  This  gives  the  user  a  very-  powerful 
ability  to  control  the  HAARP,  but  this  facility  should  be  used  with  extreme  caution. 

If  a  problem  arises  and  the  dictionary  in  the  EEPROM  is  corrupted  so  that  you  can 
no  longer  recover  the  system,  you  can  jump  stan  the  68HC1 1  by  disabling  the  chip  select 
pin  on  the  EEPROM  and  then  rebuild  the  system  from  the  basic  FORTH  kernel  burnt  in 
on  the  chip's  ROM.  (See  Section  7.7)  The  FORTH  code  can  then  be  downloaded  from 
any  computer  as  ASCII  text  files  and  then  the  new  dictionary  can  be  stored  in  the 
EEPROM.  Therefore,  it  is  important  to  keep  the  FORTH  source  files  and  the  DSP  binary 
on  whatever  computer  is  being  used  to  controll  the  HAARP  Imager. 

The  DSP  program  is  also  supplied  for  both  reference  and  for  future  development. 
The  user  can  make  changes  to  this  code,  but  this  is  a  very  risky  step  and  you  should 
always  make  sure  that  you  do  not  change  the  latest  binary  (KE08.DSP  as  of  1 1/91)  so  that 
you  can  recover.  Once  you  have  changed  the  DSP  assembly  language  program,  you  need 
to  assemble  it  using  the  DSP  assembler  and  then  download  this  to  the  FORTH  EEPROM 
using  the  FORTH  word  DNLD.  Once  this  is  stored  in  the  system’s  EEPROM,  the  DSP 
can  be  initialized  with  this  new  binary  by  INlTializing  it. 

For  more  information  on  the  above,  please  refer  to: 

MaxFORTH  Reference  Manual  New  Micro 

68HC11  Reference  Manual  Motorola 

56001  DSP  Reference  Manual  Motorola 
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7.2  Advanced  Technologies  FORTH  and  DSP  Code 


The  Advanced  Technologies  FORTH  Code  contains  all  the  necessary  words  to 
control  the  DSP  processor,  the  CCD  Camera  electronics,  and  the  EEPROM/RAM 
funcdons.  Normally,  you  shouldn't  have  to  worry  about  this  code,  and  will  be  modifying 
or  adding  new  dictionary  words  in  the  HAARP  FORTH  code.  However,  if  somehow  you 
have  corrupted  or  need  to  change  the  Advanced  Technologies  code,  there  arc  6  files  that 
need  to  be  loaded.  They  are  (in  order  of  loading):  {The  7  corresponds  to  the  version  #  — 
There  might  be  more  recent  versions  as  of  this  documentation  } 


KEOasm? 

KEOrom? 

KEOdsp? 

KEOadc? 

KEOtim? 

KEOcmd? 


;  Contains  68HC1 1  assembler  words 
;  Contains  words  for  EEPROM/RAM  control 
;  Contains  words  for  DSP  control 
;  Contains  words  for  ADC  prort  (PortE) 

;  Contains  the  CCD  timing  state  definitions 
;  Contains  the  CCD  control  command  words 


Each  file  stans  with  a  FORGET  command.  This  erases  the  current  dictionary  from  there 
on.  If  you  made  a  change  in  KEOdsp?,  you  will  need  to  reload  everything  from  KEOdsp? 
onwards.  After  you  have  loaded  the  Advanced  Technologies  FORTH  files,  you  will  then 
need  to  load  the  current  HAARP  FORTH  file.  For  historical  reasons,  the  HAARP 
FORTH  file  is  called  MIPXX.FOR,  where  XX  is  the  version  number.  This  is  because  this 
code  was  originally  developed  for  the  MIP  instrument  and  the  programs  are  identical. 

As  of  8/93,  the  version  number  is  10:  MIPIO.FOR 


Loading  all  the  FORTH  files  will  have  modified  the  dictionary  residing  in  the  RAM  and 
you  should  immediately  be  able  to  test  out  these  changes.  However,  if  you  power  down 
the  processor,  these  changes  will  be  lost  as  the  EEPROM  wasn't  changed. 

Once  you  are  sure  that  your  changes  work,  and  these  changes  have  been  saved  in  a 
set  of  files  with  a  new  version  number  (i.e.  KEOasm9  or  MIPl  1  .FOR),  you  can  store  thi.s 
now  dictionary  in  the  EEPROM  by  typing: 

STORE 

(returns)  DICTIONARY  STORED  9465  BYTES 
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This  will  take  a  few  minutes  and  will  retuni  with  a  status  message.  Once  you  have  stored 
the  dictionary,  the  autostart  sequence  must  be  updated  to  point  to  the  new  dictionary 
address.  To  do  this  type: 

MSTART! 

(returns)  AUTOSEQUENCE  STORED 

Now  you  can  turn  the  power  off  and  your  changes  will  be  saved.  If  something 
catastrophic  has  happened  and  you  cannot  recover,  read  Section  7.7  on  recovering  the 
EEPROM. 

The  DSP  assembler  code  is  listed  as: 

KE08.ASM  ;  version  8  as  of  1 1/91 

The  D.SP  binary  (after  assembly)  code  is  listed  as: 

KE08.DSP  ;  version  8  as  of  1 1/91 

If  you  ever  change  the  DSP  code,  you  will  need  to  download  KE08.DSP  as  an  ASCII  file 
after  you  have  typed  the  command  on  the  68HC1 1 : 

DNLD 

The  68HC11  will  capture  all  the  DSP  code  stored  as  ASCII  characters  until  the 
terminating  character  is  sent.  Please  note  that  the  output  file  of  the  DSP  assembler  needs 
to  modified  before  being  sent  to  the  68HC11.  If  you  cannot  determine  the  required 
changes  by  comparing  files,  contact  Advanced  Technologies. 

7.3  HAARP  FORTH  Code 

FORTH  code  for  the  HAARP  was  written  by  KEO  Consultants  to  control  the 
HAARP  specific  electronics  and  to  provide  a  quick  protected  interface  to  communicate 
with  the  host  processor. 
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The  KEO  Interface  Control  CCA  talks  to  the  68HC 1 1  through  the  parallel  ports  PB 
and  PC,  where  B  is  the  address,  and  C  is  the  data.  An  address  demultiplexing  GAL  on  the 
board  deciphers  whether  data  put  on  the  bus  is  for  the  KEO  Interface.  It  has  been 
programmed  for  address  hex  B400  and  is  stored  in  the  constant: 

B400  CONSTANT  lOCTL 
VARIABLE  MIPSTS 
VARIABLE  MIPCTL 

The  variable  MIPSTS  stores  the  last  read  byte  from  the  KEO  Interface  CCA,  and  the 
variable  MIPCTL  stores  the  last  written  byte  to  the  KEO  Interface  CCA.  These  variables 
are  used  to  mask  in  new  command  bits  which  control  specific  parts  of  the  HAARP 
electronics. 

Since  serial  communications  is  comparably  slow,  a  set  of  utilities  was  written  to 
accept  characters  from  the  host  without  echoing.  The  input  command  is  a  character  which 
then  gets  mapped  to  a  command  list  numerically  using  the  FORTH  .‘CASE  statement.  To 
receive  numerical  input  from  the  host,  the  word  GETNUM  is  used.  It  accepts  all 
characters  without  echoing  until  a  <cr>  is  received.  GETNUM  then  convens  this  SL  ag 
into  a  number  and  leaves  it  on  the  stack. 

The  HAARP  FORTH  code's  last  dictionary  words  deal  with  restoring  the  systeni 
on  power-up  or  reset,  and  defining  the  auto-start  sequence.  This  is  critical  code  and 
should  not  be  modified.  IT  SHOULD  ALWAYS  BE  THE  LAST  THING  LOADED 
INTO  RAM.  If  any  modifications  were  made  to  the  EEPROM  (i.e.  by  using  the  STORE 
command),  you  must  also  do  a  MSTART!  to  update  the  autostart  address  in  the  EEPROM. 

MIPIO.FOR  contains  all  the  FORTH  words  necessary  for  the  host  to  control  all 
HAARP  and  CCD  functions.  Upon  power-up,  the  processor  is  in  a  loop  "MIP"  and  can 
only  accept  the  finite  commands  we  allow.  However,  at  any  time  the  host  can  cither 
restart  the  processor  (COLD  boot)  or  exit  the  MIP  loop  to  the  FORTH  kernel  mode.  At 
this  point  any  command  from  the  dictionary  can  be  used.  New  words  can  be  defined  and 
executed  as  in  any  FORTH  system.  Again,  these  will  not  be  remembered  unless  you 
STORE  the  dictionary  in  the  EEPROM. 
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7.3.1  MIF  Variables 


IN_BUFF 

lOCTL 

MIPSTS 

MIPCTL 

ERRLVL 

ERRSTS 

NUM_CMD 

MSTART 


a  five  character  input  buffer  —  could  increase  the  size  if  necessary 
a  Constant  representing  the  address  of  the  KEO  Interface  GAL 
variable  holding  the  last  byte  read  from  the  KEO  Interface  CCA 
variable  holding  the  last  byte  written  to  the  KEO  Interface  CCA 
variable  holding  the  error  level  for  error  reporting 
variable  holding  a  sutus  word  for  the  current  errors 
a  Constant  storing  the  number  of  MIP  commands  defined, 
if  you  add  commands,  you  need  to  change  this  accordingly 
a  Constant  representing  the  address  of  the  EPROM.  Used  for  the 
autostart  routine 


7.3.2  MJP  Utility  Words 

GETNUM  Receives  character  input  until  a  <cr>  has  been  received,  and 

then  converts  this  to  a  number  leaving  the  value  on  the  stack. 
Note:  Could  add  a  timeout  functionality  to  this,  in  case  a 
<cr>  is  never  received. 

TERM_EMIT  Emits  a  "#".  This  is  used  as  a  terminating  character 

notification  to  the  host. 

CGAIN  Uses  the  .CASE  dictionary  event  to  execute  cither  the  HI- 

GALN,  MID-GAIN,  or  LO-GAIN  commands  based  on  tlie 
number  on  the  stack  (0-2).  Does  no  error  checking,  so  this 
MUST  be  done  before  CGAIN  is  called.  The  words 
executed  set  the  CCD  camera  gain  for  the  ADC  conversion. 

CTL!  Stores  the  byte  on  the  stack  in  MIPCTl,  and  outputs  this  to 

the  device  at  location  lOCTL  (in  this  case  the  KEO  Interface 
CCA). 

CTL(§)  Reads  the  byte  at  location  lOCTL  (KEO  Interface  CCA)  and 

stores  the  value  in  MIPSTS  and  also  leaves  it  on  the  stack. 


186 


ERR! 


OR’s  in  the  present  error  bit  on  the  stack  into  the  error  status 
word  ERRSTS. 


ERRCHK  ( <cond>  <erT#>  ERRCHK  <continue  flag> ) 

ERRCHK  looks  at  a  condition  <cond>left  on  the  suck,  and 
sets  the  error  bit  determined  by  <erT#>  into  the  error  sums 
word  depending  on  the  ERRLVL  set  for  the  system. 

SHTR_STS  Gets  the  sums  bits  of  the  shutters  on  leaves  them  on  the 

suck  as  BO  andBl. 

CLS  Closes  both  shutters  with  no  sums  check.  Does  not  modify 

the  suck  at  all,  and  does  not  update  MIPCTL  or  MEPSTS. 

OPS  Opens  both  shutters  with  no  sutus  check.  Does  not  modify 

the  stack  at  all,  and  does  not  update  MIPCTL  or  MIPSTS. 

7.3 J  Error  Checking  System 

An  error  reporting  scheme  has  been  implemented  on  the  HAARP  imager.  There 
are  three  levels  of  error  reporting  that  can  occur: 

0  No  error  reporting,  continue  operation 

1  Repon  error,  but  continue  operation 

2  Repon  error,  abort  operation 

The  Utility  word  ERRCHK  is  used  to  implement  this  feature.  The  error  reporting  is 
determined  by  the  error  level  stored  in  the  variable  ERRLVL.  This  error  level  is  set  by  the 
host  dynamically.  The  default  error  level  is  always  2  (report  and  abort).  Functions  that 
remm  errors  report  all  errors  as  negative  numbers. 
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7.3.4  MEP  Command  Words 


Note:  All  the  command  words  follow  the  MIP  command  format  and  finish  by 
emitting  the  terminating  character  None  of  these  commands  modify  the  stack  in  any 
way. 


RD_SHTRS  Reads  the  shutter  status,  pops  this  value  off  the  stack  and 

emits  the  teiminating  character. 

OPEN_SH1  Opens  Shutter  1,  waits  100  msec,  reads  the  shutter  status, 

and  returns  0  if  open,  and  -1  if  closed  (error),  and  finally 
emits  the  terminating  character. 


OPEN_SH2  Opens  Shutter  2,  waits  100  msec,  reads  the  shutter  status, 

and  returns  0  if  open,  -2  if  closed  (error),  and  finally  emits  the 
terminating  character. 

CLOSE_SH1  Closes  Shutter  1,  waits  100  msec,  reads  the  shutter  sutus 

and  returns  0  if  closed,  - 1  if  open  (error),  and  finally  emits  the 
terminating  character. 


CLOSE_SH2  Closes  Shutter  2,  waits  100  msec,  reads  the  shutter  status 

and  returns  0  if  closed,  -2  if  open  (error),  and  finally  emits  the 
terminating  character. 

OPEN_SKTS  Opens  ixith  shutters  simultaneously,  waits  100  msec,  reads 
the  shutter  sutus,  and  returns  0  if  both  are  open,  6  if  shutter 
1  is  closed  (error),  5  if  shutter  2  is  closed  (error),  7  if  both  are 
closed,  (ciTor),  and  then  emits  the  terminating  character. 


CLOSE_SHTS  Closes  both  shutters  simultaneously,  waits  100  msec,  reads 
the  shutter  status,  and  returns  0  if  both  are  closed,  6  if  shutter 
1  is  open  (error),  5  if  shutter  2  is  open  (error),  7  if  both  are 
open  (error),  and  then  emits  the  terminating  character. 
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CCD_BIAS 

2BIN 

1BIN 

CCD_GAIN 

DARK 

DEFAULT 

EXPOSE 


Closes  the  shutters  (with  no  status  check),  clears  the  CCD 
three  times  (to  scrub  out  any  residual  charge),  reads 
the  CCD  and  finally  emits  the  terminating  charaaer.  Does 
not  modify  the  stack  in  any  way. 

Sets  the  CCD  to  read  out  in  2x2  binning  with  256x256 
serial  and  parallel  lengths.  Emits  a  terminadng  character. 

Sets  the  CCD  to  read  out  in  1x1  binning  with  512x512 
serial  and  parallel  lengths.  EmiLs  a  terminating  character. 

Gets  the  Gain  selection  from  the  host,  checks  for  >2 
condition  and  returns  a  -1  (error)  if  so.  If  no  limit  problem 
sets  die  CCD  ADC  gain  using  the  CGAtN  and  emits  an  0 
(no  error)  and  the  the  terminating  character. 

Gets  the  exposure  time  in  deciseconds,  checks  and  makes 
sure  there  is  no  zero- length  exposure  returning  a  -1  (error). 
If  it  is  a  valid  exposure  time  a  dark  exposure  is  taken  and  a 
terminating  character  is  emitted. 

Sets  die  CCD  to  the  default  readout  parameters  initially  set 
by  Advanced  Technologies.  The  CCD  will  subsequently  be 
readout  as  a  1x1  binned,  512x512  image. 

Gets  the  exposure  time  in  deciseconds,  checks  to  see  if  the 
exposure  is  <  2  deciseconds  returning  a  - 1  (error)  if  true. 

If  i:  is  a  valid  exposure  time  the  shutters  are  closed  (with  no 
status  check),  the  CCD  is  cleared,  and  the  shutters  are 
opiened.  After  100  msec  the  shutters  are  checked  and  error 
codes  are  returned  if  they  are  not  both  opened  (B2  flags 
error,  BO,  B1  give  shutter  status).  If  both  shutters  are 
opened,  the  expose  time  minus  100  msec  is  waited  and  the 
shutters  are  subsequently  closed.  The  CCD  is  not  read. 
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FOCUS 


OBS 


SET-ERR 


HWED 


Focus  is  not  presently  implemented  and  just  emits  the 
terminating  character.  The  read  rate  of  the  MIP  is  so  fast, 
that  it  has  not  been  necessary  to  implement.  Also,  the  user 
can  use  the  aquisidon  table  to  condnuously  run  an  entry  if 
focus  is  really  desired. 

The  basic  sequence  for  an  'observe'  is: 

(o)  get  exposure  time  in  deci  seconds 
(i)  check  exposure  limit  >  100  msec... 

(li)  close  the  the  shutters  and  clear  the  CCD... 

(iii)  open  the  front  shutter  and  check... 

(iv)  read  the  intensifier  photodiode  and  check 

for  AGC  satxiradon... 

(v)  open  the  back  shutter  and  check... 

(vi)  wait  for  x  deciseconds... 

(vii)  close  shutters,  check  and  read  CCD... 

The  return  codes  for  the  errors  are: 

(i)  -1  (iii)  -2  (iv)  -4  (v)  -8  (vii)  -16 

'OBS'erve  will  execute  according  to  the  error  reporting  level 
set  as  discussed  Ln  7.3.3.  At  terminadon  of  OBS,  a 
terminauon  character  is  emined. 

SET-ERR  accepts  a  new  error  reporting  level,  checks  for 
limit  errors  (0->2)  and  reports  a  -1  if  there  was  an  error. 

If  not,  the  new  error  level  is  stored  in  ERRLVL  and  a  0  is 
emitted  alc'i._,  A'ith  the  terminating  character. 

Commands  the  DSP  to  create  a  horizontal  wedge  pattern 
and  then  emits  a  terminating  character.  This  shade  is 
generated  by  the  DSP  chip  to  increase  the  pixel  intensity 
every  64  pixels  starting  at  an  intensity  of  0.  This  gives  a 
pattern  with  every  pixel  value  from  0  to  4095  (12  bits).  This 
command  is  useful  to  quickly  test  the  camera  operation  and 
the  digital  interface.  HWED  emits  a  terminating  ciiaracter. 
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CCD_CLR 

CCD_READ 

SET_FILPOS 


SETJNTGAIN 


INT_ON 

INT_OFF 

RD  INTGAIN 


Clears  the  CCD,  and  emits  a  terminating  character. 

Reads  the  CCD,  and  emits  a  terminating  character. 

Gets  a  number  from  the  host,  checks  for  limits  and  returns  a 
-6  if  there  was  an  input  error.  Gets  the  last  command  from 
MIPCTL,  masks  in  the  new  filter  wheel  target  (B0-B2)  and 
outputs  this  to  the  Interface  board.  The  Interface  board  is 
then  read  every  20  msec.  The  filter  wheel  position  is 
masked  out  and  checked  with  the  target  position.  If  they  are 
not  equal,  this  process  is  repeated  undl  the  filter  wheel  has 
reached  the  target,  or  1  second  has  elapsed.  If  the  filter 
wheel  reaches  the  target,  the  new  present  position  read  is 
returned  along  with  the  terminating  character.  If  not,  the 
fUterwheel  position  is  negated  and  returned  along  with  the 
terminating  character. 

Gets  a  number  from  the  host,  checks  for  limits  and  returns  a 
-6  if  there  was  an  input  error.  The  command  is  then  shifted 
into  the  output  byte  (B3-B4)  and  outputted  it  to  the  Interface 
card.  After  1  msec,  the  interface  card  is  read  (IG),  compared 
with  the  output  cmd,  returns  a  0  if  they're  equal  or  a  *10  if 
they're  not.  Finally,  SET_INTGAIN  emits  a  terminating 
character. 

Turns  on  the  Iiitensifier  Power  control  bit  in  the  output  byte 
(B5),  outputs  it  to  the  Interface  card,  and  returns  the 
terminating  character. 

Turns  off  the  Intensifier  Power  control  bit  in  the  output  byte 
(B5),  outputs  it  to  the  Interface  card,  and  returns  the 
terminating  character. 

Reads  the  status  byte  from  the  Interface  card,  masks  out  the 
intensifier  gain  bits  (B4-B5),  returns  this  value,  atid  emits  a 
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tenninating  character. 


RD_FILPOS  Reads  the  status  byte  from  the  Interface  card,  masks  out  the 

filter  wheel  position  bits,  returns  this  value,  and  emits  a 
tenninating  character. 

SET_MIPBYT£  Gets  a  number  from  the  host,  outputs  this  to  the  Interface 
card  and  emits  a  tenninating  character.  Does  no  error 
checking  to  make  sure  this  number  is  valid. 


RD_MIPBYTE  Reads  the  Interface  status  byte,  returns  thi.^  to  the  host  and 
emits  the  terminating  character. 

RD_POSERR  Reads  the  Interface  status  btye,  masks  out  the  positic''  em>r 
bit  (33).  returns  this  to  the  host  and  emits  the  termina,.  .j 
character. 


RD_TEMPS  Sets  up  the  68HC1 1  ADC  to  read  PEO  -  PE3  (the 

temperature  channels),  outputs  these  four  temperature 
values  to  the  host,  and  emits  the  terminating  character. 
Each  channel  is  read  separately  four  times  and  averaged. 
The  output  is  read  as:  CCD  TEC  INT  FILT 

RD_INTBRT  Sets  up  the  68HC1 1  ADC  to  read  PE4  four  times  (the 

intensifier  brightness  as  measured  by  the  photodiode), 
takes  an  average  and  outputs  this  to  tlie  hosi,  and  emits 
the  tenrunadng  character. 


7.3.5  MiP  Command  Loop  Words 

MIP_CMD  M1P_CMD  is  set  up  as  a  command  lookup  table  that 

executes  a  command  from  a  list  based  on  an  offset  number 
on  the  stack.;  i.e.  4  MIF_CMD  would  execute  the  fifth 
command  word  deimed  in  the  iCASL  statement 


197. 


MIP 


MIP  is  the  actual  command  loop  that  is  executed  upon 
power-up  or  reset.  This  loop  just  waits  for  a  command, 
check  the  limits  for  a  valid  command  and  then  converts  this 
command  into  an  offset  for  the  command  list  MIP_CMD. 

Once  the  command  Is  executed,  MIP  checks  to  see  if  the 
offset  was  0  (an  "exit  loop"  command),  and  if  so  exits  to  the 
FORTH  environment  If  not,  there  is  space  to  execute  the 
system  cop  utility.  This  is  not  presently  implemented. 

7.3.6  Autostart  handling  Words 

MIPiNIT  MIPINTT  is  the  initialization  routine  for  the  system.  This  is  the 

first  word  to  get  executed  upon  power-up.  MIPINTT 
retrieves  the  FORTH  dictionary  from  the  EEPROM  and 
moves  it  into  the  system  RAM.  The  hardware  is  initialized 
using  the  FORTH  word  INIT  which  loads  up  the  the  DSP 
code  into  its  RAM,  and  then  initializes  the  DSP.  Once  this 
is  completed,  the  command  loop  MIP  is  initiated. 

MSTART!  MSTART!  stores  the  starting  address  of  the  initialization 

routine  MIPINIT  in  the  autostan  location  of  the  68HC1 1. 

This  is  the  first  addre.ss  that  is  looked  at  upon  power-up  and 
is  used  to  execute  MIPINIT.  This  function  should  always  be 
last  in  the  dictionary  and  executed  after  a  STORE  to 
preserve  the  new  dictionary  structure. 

7.4  System  Cop  explanation 

The  system  cop  is  a  feature  of  the  68HC1 1  that  allows  the  processor  to  reset  itself 
if  the  program  hangs  up.  TTiis  is  done  by  having  your  program  constantly  writing  a  known 
pattern  to  a  resen-ed  location.  If  your  program  hangs,  this  location  is  no  longer  modified 
and  the  68HC1 1  recognizes  that  the  program  has  hung,  initiating  a  COLD  boot.  This 
feature  needs  to  be  implemented  using  the  WIPE  utility  which  is  located  on  the  IBM  PC. 
Unfortunately,  to  enable  and  disable  the  system  cop,  you  need  to  write  to  it’s  registers 
within  the  first  few  system  ticks  (see  WIPE  documentation).  Tliis  is  all  done  via  the  serial 
communications,  and  is  not  that  easy. 
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In  view  of  this,  the  system  cop  is  not  presently  implemented.  If  it  seems  that  it  is 
desirable,  the  MIP  loop  has  provision  for  it.  In  addition,  any  other  timing  functions  would 
have  to  be  modified  (such  as  WATTs,  and  DSP_WArT).  For  more  information,  read  the 
68HC1 1  reference  manual,  the  MaxFORTH  manual,  the  WIPE  documentation,  and  if  still 
confused,  call  New  Micro! 

7.5  MIP  Command  Format  Summary  from  Host's  point  of  view 


(C  Programming  format) 


COLD 

‘1* 

None 

%s 

None 

CCD_BIAS 

’2’ 

None 

None 

'#• 

CCD_READ 

■3’ 

None 

None 

CCD_CLR 

•4* 

None 

None 

1BIN 

'5' 

None 

None 

’#■ 

2BIN 

’6’ 

None 

None 

DEFAULT 

'T 

None 

%s 

CCD_GAIN 

'8' 

%cJ\r 

%d 

•#’ 

DARK 

'9' 

%d\r 

%d 

OBS 

( .t 

%d\r 

%d 

EXPOSE 

*  .* 

» 

7oCl\r 

%d 

’#• 

FOCUS 

None 

None 

HWEC 

1  f 

None 

None 

’#■ 

SET-ERR 

%d\r 

%d 

'#■ 

OWED 

None 

None 

OPEN_SH1 

None 

%d 

'r 

OPEN_SH2 

'A' 

None 

%d 

CLOSE_SH1 

'B' 

None 

%d 

CLOSE_SH2 

'C 

None 

%d 

OPEN  SHTS 

’D’ 

None 

%d 
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CLOSE_SHTS 

'E‘ 

None 

%d 

•#• 

SET_FILPOS 

'P 

%d\r 

%d 

SETJNTGAU 

’G’ 

%d\r 

%d 

•#’ 

SET.MIPBYTE 

•H' 

%d\r 

None 

•#' 

INT_ON 

T 

None 

None 

•#’ 

INT_OFF 

'J' 

None 

None 

’#• 

RD_SHTRS 

■K' 

None 

%d 

RD_FILPOS 

V 

None 

%d 

•#• 

RD_MIPBYTE 

■M' 

None 

%d 

RD  JNTGAIN 

•N' 

None 

%d 

•#• 

RD_POSERR 

•O’ 

None 

%d 

RD_TEMPS 

.p. 

None 

%d_%d_%d_%d_ 

•#' 

RDJNTBRT 

■Q’ 

None 

%d 

•#• 

7.6  Advanced  Technologies  CCD  Format  parameters 


The  CCD  read  format  parameters  are  located  in  the  KEOcmd?  code: 


VARIABLE 

SLENGTH 

VARIABLE 

PLENGTH 

VARIABLE 

SBINNUM 

VARIABLE 

PBINNUM 

VARIABLE 

SPRESCAN 

VARIABLE 

PPRESCAN 

VARIABLE 

SPOSTSCAN 

VARIABLE 

PPOSTSCAN 

VARIABLE 

SREADLEN 

VARIABLE 

PREADLEN 

Serial  length 

Parallel  length 

Serial  binning  factor 

Parallel  binning  factor 

Number  of  serial  pixels  to  shift  before 

Stan  of  read 

Number  of  parallel  shifts  to  do  before 
Stan  of  read 

Number  of  serial  shifts  to  do  after 
end  of  read 

Number  of  parallel  shifts  to  do  after 
end  of  read 

Number  of  serial  pixels  to  read 
Number  of  parallel  rows  to  read 


The  CCD  format  parameters  arc  initialized  as; 
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DECIMAL 

516  SLENGTH  ! 

516  PLENGTH  ! 

1  SBINNUM  ! 

1  P&INNUM  ! 

20  SPRESCAN  !  ;  This  is  a  constant  due  to  physical 

;  extension  in  the  serial  register 

0  SPOSTSCAN ! 

0  PPRESCAN  ! 

0  PPOSTSCAN  ! 

516  SREADLEN  ! 

516  PREADLEN  ! 

The  INIT-FORMAT  command  takes  the  values  presently  stored  in  the  above 
variables  and  stores  them  in  the  DSP  chip.  To  change  the  readout  of  the  CCD,  any  of  the 
above  can  be  changed,  and  then  INIT>FORMAT  executed. 


7.7  Recovering  from  a  ROM  Crash 

If  you  think  that  the  ROM  on  the  Advanced  Technologies  Controller  board  has 
been  corrupted,  here  is  a  recovery  procedure. 

If  you  connect  the  camera  to  a  terminal  and  then  reset  the  68HC1 1,  and  do  not  get 
a  response  (i.e.  the  startup  text  does  not  appear),  then  you  should  first  suspect  the  ROM. 
Of  course,  there  could  be  many  other  errors  that  a  corrupted  ROM  might  produce,  but  this 
procedure  addresses  a  fatal  error. 

Upon  resetting  the  68HC11,  it  tries  to  load  the  code  in  the  ROM  (U15)  into  it's 
RAM  (U8).  If  there  is  a  problem,  it  will  never  succeed  and  hence  never  get  into  the 
interactive  mode.  The  MIP  autostart  routine  boots  the  FORTH  chip,  restores  the  ROM, 
initializes  the  DSP  chip,  and  then  starts  the  MIP  command  loop,  which  leaves  a  on  the 
terminal  and  waits  for  the  next  valid  command  as  defined  by  the  MIP  code.  A  "0"  gets 
you  back  to  the  FORTH  kernel,  and  a  ’T"  gives  you  a  cold  boot.  If  these  don't  work, 
chances  are  the  ROM  has  been  corrupted. 
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The  first  step  to  rebuilding  the  ROM  is  to  remove  UlS  (the  ROM)  and  gently  bend 
pin  20  (chip  select)  up.  Using  small  clip  leads  connect  this  pin  to  +5V  through  a  lOK 
resistor.  Now  power  up  the  board.  You  should  see 

MaxForih  3.3 

This  tells  you  that  the  68HC1 1  is  working  from  it's  internal  ROM  which  has  the  FORTH 
kernel  in  it.  If  you  don't  get  this,  there  must  be  another  problem  with  the  board,  or  perhaps 
even  in  your  communications  set  up.  (Is  your  terminal  set  correctly?  9800B,  8Bits,  IStop, 
No  Parity). 

If  you  do  get  this  identifier,  you  are  now  ready  to  download  the  KEO  Forth  code. 
Start  with  an  ASCII  send  of  KEOASM7.  As  each  es,  it  will  prompt  you  to  send 

the  next  file  to  the  68HC11.  After  you  have  fi,.,.  i^.  nding  all  the  ASCII  files,  the 
program  is  in  the  controller's  RAM  (U8). 

The  next  step  is  to  download  the  DSP  hex  code.  Type  the  following  command  to 
the  68HCli: 

DNLD 

The  68HC11  is  now  waiting  for  an  ASCII  file  containing  the  HEX  code  for  the  DSP. 
Send  the  file:  KE07.DSP.  A  stream  of  HEX  numbers  should  appear  on  the  terminal.  This 
is  terminated  by  a  $  upon  which  the  68HC1 1  should  output; 

DOWNLOAD  COMPLETED 

Hit  a  couple  of  <cr>  to  make  sure  you  still  get  the  "OK"  prompt. 

Type: 

INIT 

and  watch  the  DSP  chip  initialize.  If  it  completes  this,  your  board  is  now  working  again. 

At  this  point  though,  it  is  necessary  to  store  this  recreated  code  in  RAM,  back  into 
ROM.  Presently  the  ROM  is  disabled  because  the  chip  select  pin  is  pulled  high  through 
the  lOK  resistor.  With  the  board  still  powered  on.  very  carefully  disconnect  the  pullup 
resistor  aj  d  connect  the  pin  back  into  it's  socket.  Don’t  try  bend  it,  just  clip  on  to  it.  Now 
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the  ROM  chip  select  is  reconnected  and  you  can  store  the  RAM  dictionary  into  the  ROM. 
Type  the  command: 


STORE 

STORING  DICTIONARY 


After  a  few  minutes,  the  68HC1 1  will  output: 

STORE  COMPLETED 

At  this  point,  it  is  necessary  to  store  the  autostan  routine: 

MSTART! 


If  all  has  gone  well,  you  have  now  successfully  recovered  the  68HC1 1  ROM.  To  test, 
power  down  the  controller  board  (or  just  do  a  reset  or  COLD)  and  make  sure  that  all  the 
start  prompts  appear  and  that  the  processor  comes  up  in  the  MIP  command  mode  as  usual. 

Order  for  sending  ASCII  text  files  to  the  68HC1 1 

•  KEOasm? 

•  KEOrom? 

•  KEOdsp? 

•  KEOadc8 

•  KEOtim? 

•  KEOcmd? 

•  MIPIO.FOR 

•  Download:  KE08.DSP 
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Chapter  8  FORTH  Code  Listings 


8.1  MIPIO.FOR  KEO  Consultants  Code  for  Camera  Controller 


( MIPIO.FOR 

( 

( 07/23  mod: 

( 09/21  mod; 
(09/21  mod: 

( 

( 09/21  mod: 

( 


KEO  CONSULTANTS  ) 
LAST  MODIFIED  BY:  CAL07/23/93  ) 


Added  better  resoludon  to  Set_filpos  ) 

Added  error  level  system  ) 

Changed  all  error  codes  to  return  a  ) 

negative  number.  ) 

SET_FILPOS  poles  for  correct  position  ) 

instead  of  just  waiting  1  second  ) 


(  New  software  development  for  MIP  camera.  Interface 
( to  Master  through  serial  pon.  using  SYSTEM  COP,  and 
(  no  echoing  of  characters. 

( 

( COMMENTS;  Presently,  the  System  Cop  is  not  imple- 
(  mented.  All  functions  do  range  checking. 

(  Another  function  could  be  added  to  create 
(  a  timeout  error  on  GETNUM  to  decrease  the 
(  chance  of  a  communications  lock-up.  A 
(  new  version  has  been  written  that  has  a 
(  two  letter  command  staning  with  the 
(  character  "C",  and  has  been  tested  and 
(  works,  but  1  have  not  implemented  it  as 
(  as  I  don't  think  it  is  presently  necessary 


) 

) 

) 

) 

) 

) 

) 

) 

) 

) 

) 

) 

) 

) 


(WARNING:  Do  not  use  TABs  in  any  FORTH  file!  ) 
FORGET  IN.BUFF 


(  Create  an  Input  Buffer  for  incoming  parameters  ) 

DECIMAL 


CREATE  IN_BUFF  5  ALLOT 
IN.BUFF  5  ERASE 
5  IN.BUFF  C! 

(  Create  the  word  to  receive  ASCII  numbers  GETNUM  ) 


GETNUM  IN.BUFF  1-t-  4  ERASE 
4  0  DO  KEY  UUP 
13  =  IF  DROP  LEAVE 
THEN  IN_BUFF‘  1  +  l-i-  C!  LOOP 


(  Erase  input  buffer  ) 
(  Get  input  character  ) 
(  Check  to  see  if  <CR>  ) 
(  Store  the  character  ) 
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0  1  EN_BUFF  CX)NVERT  DROP  DROP ;  (  Convert  to  num  ) 

HEX 

B400  CONSTANT  lOCTL  (  M)  CONTROL  REGISTER  LOCATION  ) 

DECIMAL 

VARIABLE  MIPSTS  ( LAST  READ  MIP  STATUS ) 

VARIABLE  MIPCTL  ( LAST  WRITTEN  MIP  COMMAND ) 

VARIABLE  ERRLVL  ( ERROR  LEVEL ) 

VARIABLE  ERRSTS  ( ERROR  STATUS  WORD ) 

( MIP  Utilities  for  KEO  Software  Control  ) 

;  TERM_EMrr  35  EMIT  ;  (  Emit  to  terminal ) 

;CASE  CGAEM  LO-GAIN  MID-GAIN  HI-GAIN  ;  ( Select  CCD  Gain ) 

:  CTL!  ( WRITES  A  BYTE  TO  THE  10  CONTROL  RECITER ) 

DUP  MIPCTL  C!  lOCTL  C! ; 

1  CTL!  ( INITIALIZE  TO  IRST  FILTER,  INT.  OFF  WITH  0  GAIN) 

;  CTL@  ( READS  A  BYTE  FROM  THE  10  CONTROL  REGISTER  ) 

lOCTL  QS)  DUP  MIPSTS  C!  ; 

:  ERR!  ERRSTS  @  OR  ERRSTS  !  ;  ( OR'S  IN  THE  PRESENT  ERROR  BIT ) 

{  ERRCHK:  CHECKS  ERROR  LEVEL.  AND  REPORTS  AND  LEAVES  A  CONTINUE  FLAG  ) 


(  DEPENDl  NG  ON  THE  ERROR  REPORTING  LEVEL  ) 

(  0:  IGNORE  ALL  ERRORS  ) 

(  1;  REPORT  AIX  ERRORS,  BUT  DONT  ABORT  OPERATION  ) 

(  2:  REPORT  ALL  ERRORS,  AND  ABORT  OPERATION  ) 


:  ERRCHK  (  <con(iition>  <crrtt>  ERRCHK  <coniinue  flag>  ) 
SWAP 

IF  ERRLVL  @  2  = 

IF  ERR!  0 
ELSE 

ERRLVL® 

IF  ERR! 

ELSE  DROP 
THEN  1 
THEN 

ELSE  DROP  1 
THEN  ; 
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HEX 


:  SHTR_STS  { GET  THE  STATUS  BITS  OF  THE  SHUTTERS  AND  LEAVE  ON  STACK ) 

CTL@C0AND  (READ  AND  MASK  INPUT  BYTE) 

2/  2/  2/  2/  2/  2/ ;  ( SHIFT  DATA  TO  BO-Bl ) 

:  CLS  ( CTOSE  BOTH  SHUTTERS  WITH  NO  STATUS  CHECK ) 

PORTA  C@  F-5  F-6  PORTA  C! ; 

:OPS  (OPEN  BOTH  SHUTTERS  WITH  NO  STATUS  CHECK) 

PORTA  C@  T-5  T-6  PORTA  C!  ; 


( KEO  Dictionary  for  MIP  control  words  in  order  of  CASE  ) 


DECIMAL 

:  SYSTEM 

TERM_EMIT ; 

:  RD  SHTRS 

SHTR.STS 
.  TERM.EMIT ; 

:  OPEN  SHI 

PORTA  C@  T-6  PORTA  C! 

1  DWAIT  SHTR_STS  1  AND 

IF  0  .  ELSE  -1  .  THEN  TERM.EMIT  ; 

:  OPEN_SH2 

PORTA  C@  T-5  PORTA  C! 

1  DWAIT  SHTR.STS  2  AND 

IF  0  .  ELSE  -2  .  THEN  TERM.EMIT  ; 

:CLOSE_SHl 

PORTA  C(a'  F-6  PORTA  C! 

1  DWAIT  SHTR_STS  1  AND 

IF  - 1  .  ELSE  0  .  THEN  TERM_EMIT  ; 

:  CLOSE_SH2 

PORTA  C@  F-5  PORI  A  C! 

1  DWAIT  SHTR_STS  2  AND 

IF  -2  .  ELSE  0  .  THEN  TERM_EMIT  ; 


( RETURN  TO  FORTH  USER’S  SYSTEM ) 


( READ  THE  SHUTTER  STATUS  BITS  ) 

( GET  THE  STATUS  BITS  ON  THE  STACK  ) 
( RETURN  STATUS  ) 

(OPEN  SHUTTER#! ) 

( WRITE  BIT  TO  PORTA  ) 


( OPEN  SHUTTER  #2  ) 
(WRITE  BIT  TO  PORTA) 


( CLOSE  SHUTTER  #1  ) 

(  WRITE  BIT  TO  PORTA  ) 


(CLOSE  SHUTTER  #2) 

( WRITE  BIT  TO  PORTA ) 


201 


:  OPEN_SHTS  (  OPEN  BOTH  SHUTTERS  SIMULTANEOUSLY ) 

OPS  (  WRITE  BITS  TO  PORTA ) 

1  DWATT  SHTR.STS  DUP  3  = 

IF  DROP  0  .  ELSE  -4  OR  .  THEN  TERM_EMIT  ; 

:  CLOSE^SHTS  ( CLOSE  BOTH  SHUTTERS  SIMULTANEOUSLY  ) 

CLS  "  (WRITE  BITS  TO  PORTA) 

1  DWAIT  SHTR.STS  DUP  3  AND 

IF  -4  AND  .  ELSE  DROP  0  .  THEN  TERM.EMTT  ; 

:  CCD_BIAS  (  READ  OUT  A  BIAS  FRAME ) 

(XS  CLEAR  CLEAR  CLEAR  READ  TERM.EMTT  ; 

:  2BIN  (  SET  TO  2x2  BINNING ) 

2  SBINNUM  !  2  PBINNUM  !  256  SREADLEN  !  256  PREADLEN  ! 
INIT-FORMATTERM_EMIT ; 


:  IBEM  (SETTO  1x1  BINNING) 

1  SBINNUM  !  1  PBINNUM  !  516  SREADLEN  1516  PREADLEN  ! 
INTT-FORMAT  TERM_EMIT ; 

;  CCD  GAIN  ( SET  THE  CCD  AyD  CONVERTER  GAIN ) 

GEI  NUM  DUP  2  >  IF  DROP  - 1  .  ELSE  CG  AIN  0  . 

THEN  TERM.EMIT ; 


:  DARK  ( DARK  EXPOSURE  IN  DECISECONDS  ) 

GETNUM  DUP  1  <  IF  DROP  -1  . 

ELSE  DDARK  THEN  TERM_EMIT  ; 

:  DEFAULT  (  SET  CCD  TO  DEFAULT  PARAMETERS  ) 

( INITIALIZE  FORMAT  PARAMETERS  TO  DEFAULTS  ) 

DECIMAL 
516SLENGTH  ! 

516PLENGTH  ! 

1  SBINNUM! 

1  PBINNUM! 

20  SPRESCAN  ! 

0  SPOSTSCAN! 

0  PPRESCAN  ! 

0  PPOSTSCAN  ! 

516 SREADLEN ! 

516 PREADLEN ! 

INIT-FORMAT  (SEND  THESE  TO  THE  DSP) 

TERM_EMIT ; 
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:  EXPOSE  ( EXPOSE  CCD ) 

GETNUM  DUP  2  <  IF  DROP  -1  . 

ELSE  CLS  CLEAR  OPS  I  DWATT 
SHTR.STS  DUP  3  =  IF  DROP  1  -  DWAIT  CLS 
1  DWAIT  0  .  ELSE  CLS  -4  OR  . 

THEN  THEN  TERM_EMIT ; 

:  FOCUS  (FOCUS  LOOP)  { NOT  YET  IMPLEMENTED ) 

TERM_EMIT ; 


DECIMAL 


:  OBS  (  OBSERVE';  OPEN  SHUTTERS  3EPERATELY.  CHECK  PHOTODIODE ) 


0  ERRSTS  !  GETNUM  DUP  2  < 
1 ERRCHK 
IF  DUP  2  < 

IF  DROP  2  THEN 


( GET  EXPOSURE  TIME  IN  DEQSECONDS  ) 
(  CHECK  FOR  ERROR:  LIMTf  CHECK  ) 

( MAKE  SURE  <EXP>  IS  >  1  ) 


CLS  CLEAR 

PORTA  02)  T-6  PORTA  C! 

1  DWAIT  SHTR.STS  1  AND  0= 

2  ERRCHK 
IF 

SET-NOSCAN  SET-SINGLE 
SET-CH4  4ADC(g> 

-(--t-  +4/DUP 

180  >4  ERRCHK 
IF 

PORTA  C@  T-5  PORTA  C! 

1  DWAIT  SHTR.STS  2  AND  0= 


( SHTS  CLOSED?  CLEAR  CCD  ) 

( OPEN  FRONT  SHUTTER:  SH 1  ) 

(WAIT  AND  CHECK  IF  OPEN  ) 

( CHECK  FOR  ERROR:  OPENING  SHI  ) 


( SET  UP  ADC  MODE  ) 

(READ  ADC  CHANNEL  4  ) 

(TAKE  AVERAGE  ) 

( CFTCK  FOR  ERROR:  INT.  IN  AGC  MODE  ) 

( IF  NOT  OPEN  BACK  SHTR:  SH2  ) 

( WAIT  AND  CHECK  IF  OPEN  ) 


8  ERRCHK  ( CHECK  FOR  ERROR:  OPENING  SH2  ) 

IF 

SWAP  1  -  DWAIT  CLS  READ  ( WAIT  <N>  DSECS,  CLOSE  SHTS,  READ  CCD  ) 

SHTR_STS  16  ERRCHK  DROP  ( CHECK  FOR  ERROR:  CLOSING  SHUTTERS  ) 


ELSE  DROP  CLS  THEN 
ELSE  DROP  CLS  THEN 
ELSE  CLS  THEN 
THEN 


( DROP  <  AGO;  CLS  ERRCHK  ) 

(  DROP  <AGC>:  AGC  ERRCHK  ) 

( CLOSE  SHTS:  SHI  ERRCHK  ) 

( LIMIT  ERRCHK  ) 


ERRLVL  @ 0= 
IF. 


( IF  NO  ERROR  REPORT.. .  ) 

( OUTPUT  AGC  VAI.UE  ) 
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ELSE  ERRSTS  @  DUP  0=  ( ELSE.  CHECK  ERROR  WORD  ) 

IF  DROP.  (  NO  ERROR.  DROP  ERROR  AND  RETURN  AGC) 

ELSE  NEGATE  .  DROP  THEN  ( RETURN  -ERROR  CODE  AND  DROP  AGC  ) 
THEN  TERM.EMTT  ;  ( AND  RETURN  TERMINATING  CHARACTER ) 


:  SET-ERR 

GETNUM  DUP 
2  >  IF  DROP -1  ELSE  DUP 
0<IFDROP-1  ELSE 
ERRLVL  !  0  THEN  THEN 
.  TERM_EMIT ; 


(  SET  ERROR  LEVEL  ) 
(GET  DESTINATION  ) 
(  ERRLVL  >  2.  ERROR  ) 
(  ERRLVL  <  0.  ERROR  ) 
(STORE  THE  ERRLVL  ) 
(  RETURN  WITH  CODE  ) 


:  HWED 

SHADE  TERM_EMIT ; 


(  HORIZONTAL  WEDGE  12  BIT  TEST  PATTERN  ) 


;  OWED  (  DIAGONAL  WEDGE  12  BIT  TEST  PATTERN  ) 

(  NOT  YET  IMPLEMENTED  )  TERM_EMIT  ; 

:CCD_CLR  (CLEAR  THE  CCD  ) 

CLEAR  TERM.EMIT ; 

:CCD  READ  ( READ  OUT  THE  CCD  ) 

re"^  TERM_EMIT  : 


HEX 

;  SET  FILPOS 

GETNUM  DUP  5  > 

IF  DROP  -6 
ELSE  DUP 1  < 

IF  DROP  -6 
ELSE 

MIPCTL  C@  F8  AND  OR 
(TTL! 


( SET  RLTER  POSITION  AND  WAIT  FOR  FILTER  WHEEL  ) 


( GET  DESTINATION 
(  DESTINATION  >  5,  ERROR 
(  DESTINATION  <  I .  ERROR 


) 


(  SET  WITH  PREVIOUS  COMMAND  ) 

(  STORE  NEW  COMMAND  ANT)  OUTPUT  ) 


32  0  DO 
14  MWAIT 
CTUS)  07  AND  DUP 
MIPCTL  C@  07  AND  = 

IF  LEAVE 
ELSE  I  31  = 

IF  NEGATE  LEAVE  THEN 
THEN  DROP  LOOP 


(  SET  UP  A  WAIT  LOOP  FOR  MOVE;,  n  .  ) 

(  WAIT  20  MILLISECONDS  ) 

( GET  INPUT  BYTE  AND  MASK  ) 

( COMPARE  WITH  FW  COMMAND  ) 

( TERMINATE  THE  LOOP:  FW  PC  ON  STACK  ) 
( CHECK  TO  NUMBER  OF  WAITS .. .  ) 

( TIMEOUT  ERROR:  -FW  POS  ON  STACK  ) 

( END  OF  WAIT  FOR  MOVEMENT  LOOP  ) 


THEN 


( LIMIT  CHECKS  IF-ELSE-THEN'S  ) 
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THEN .  TERM_EMIT ;  ( RETURN  > 

:  SET_INTGAIN  ( SET  INTENSIFIER  GAIN  AND  CHECK  INTENSIFIER ) 

GETNUMDUP  ( GET  INTENSIFIER  GAIN  ) 

3  >  IF  DROP  -6  ELSE  DUP  ( GAIN  >  3,  ERROR  ) 

0<rFDROP-6  ELSE  ( GAIN  <  0,  ERROR  ) 

HEX  3  AND  2*  2*  2*  { MASK  AND  SHIFT  INPUT  ) 

MIPCTL  C@  E7  AND  OR  ( SET  PREVIOUS  COMMAND  ) 

CTL!  (OUTPUT  TO  INTERFACE  ) 

1  MWAIT  (WAITAMILLISECONT>  ) 

CTL(S)  30  AND  DUP  ( GET  INPUT  B  nE  Ah.T)  MASK  ) 

2/  2/  2/  2/  SWAP  ( LEAVE  SHIFTED  INT  GAIN  ON  STACK  ) 

MIPCTL  C(®  18  AND  2*  (COMPARE  WITH  MASKED  COMMAND  ) 

=  NOT  EF  NEGATE  THEN  ( CREATE  ERROR  CODE:  -INTGAIN  ) 

THEN  THEN  ( LIMIT  CHECK  IF-ELSE-THENS  ) 

DECIMAL .  TERM.EMIT ;  ( RETURN  ) 

:INT_ON  (TLT^N  ON  THE  IMAGE  INTENSIFIER  ) 

MIPCTTL  C@  T-5  CTL!  TERM.EMIT  ; 

:  INT_OFF  ( TURN  OFF  THE  IMAGE  INTENSIFIER  ) 

MIPCTL  C@  F-5  CTL!  TERM_EMIT  ; 

:  RD_INTG  AIN  ( READ  THE  INTENSIFIER  GAIN  ) 

crus  30  AND  (READ  AND  MASK  INPUT B’l'TE  ) 

2/  2/  2/  2/  ( SHIFT  DATA  TO  BO-B 1  ) 

.  TERM^EMIT  ;  (  RETURN  GAIN  ) 

:  RD_FILPOS  ( READ  THE  FILTER  WHEEL  POSITION  ) 

CTL<2)  7  AND  ( READ  AND  MASK  INPUT  BYTE  ) 

.  TERM.EMIT ;  ( RETURN  POSITION  ) 

:  SET_MIPBYTE  (SET  THE  MIP  OUTPUT  BYTE  ) 

GETNUM  CTL!  TERM..EMIT  ;  ( OUTPUT  BYTE  AND  RETURN  ) 

:  RD_MIPBYTE  ( LEAD  THE  MIP  INPUT  BYTE  ) 

CTT(2)  DECIMAL  .  TERM_EMrr  ;  (  READ  INPUT  BYTE  AND  RETURN  ) 

:  RD_POSERR  ( READ  THE  FW  POS.  ERROR  BIT  ) 

CTL@  MASK-3  ( READ  INPUT  BYTE,  MASK  ) 

0>  .  TERM_EMIT  ;  (  AND  RETURN  STATUS  ) 

DECIMAL 
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:  RD  TEMPS  DECIMAL  ( READ  THE  FOUR  SYSTEM 

TEMPERATURES  ) 

SET-NOSCAN  SET-SINGLE  ( SET  UP  ADC  MODE  ) 

SET-CHO  4ADC@  +  +  +  4  /  .  { READ  CCD  TEMP  ) 

SET-CHI  4ADC(2)  +  -f-  +  4  /  .  ( READ  TEC  TEMP  ) 

SET-CH2  4ADC@  +  +  +  4/ .  ( READ  INT  TEMP  ) 

SET-CH3  4ADC©  +  +  +  4  /  .  (  READ  FILT  TEMP  ) 

TF.RM_EMIT ;  ( AND  .^URN  VALUES  ) 

:  RD_INTBRT  DECIMAL  ( READ  THE  BRIGHTNESS  OF  INTENSIFIER  ANODE ) 

SET-NOSCAN  SET-SINGLE  SET-CH4  { SET  UP  ADC  MODE  ) 

4ADC@  +  +  +  4/  .  TERM_EMIT  ;  ( AND  RETURN  AVERAGE  ) 


( Set  up  MIP  Command  List ....  for  MIP  Command  loop  ! ) 


:CASE  MIP_CMD 


SYSTEM 

(0) 

COLD 

(1) 

CCD_BIAS 

(2) 

CCD.READ 

(3) 

CCD_CLR 

(4) 

IBIN 

(5) 

2BIN 

(6) 

DEFAULT 

(7) 

CCD.GAIN 

(8) 

DARK 

( 9 ) 

OBS 

(  10) 

EXPOSE 

(  11  ) 

FOCUS 

(  12) 

HWIZD 

(  13) 

SET-ERR 

(  14) 

OWED 

(  li  / 

OPEN_SHl 

(16) 

OPEN_SH2 

(17) 

CLOSE_SHl 

(  18) 

Ci.OSE_SH2 

(  19) 

OPEN.SHTS 

(20) 

CLOSE_SHTS 

(21  ) 

SET.FILPOS 

(22) 

SET^INTGAIN 

(23) 

SET.MIPBYl'E  (  24  ) 

INT_ON 

(25) 

INT_OFF 

(26) 

RD_SHTRS 

(27) 

RD_FILPOS 

(28) 

RD_MIPBYTE 

(29) 

RD_INTGAIN  (  30 ) 

RD._POScRR 

(31  ) 

RD_TEMPS 

(32) 

RD..INTBRT 

(  33  ) ; 

(  END  OF  MIP_CMD  LIST 

6/4/91  CAL  ) 

34  CONSTANT  NUM_CMND 


(MIP  COMMAND  LOOP  USING  SYSTEM  COP  6/22/91  CAL  ) 

;  MIP  ( COMMAND  LOOP  FOR  MIP  USER  ) 

."  MEP  Control  Software  Versio.".:  19  "  CK 
."  Hit  'O'  to  return  to  FORTH  Kernel "  CR 

TERM_EMIT  ( EMIT  .V  TOR  ACKNOLEDGMENT  ) 

BEGIN  7TERMINAL  ( CHECK  FOR  TERMINAL,  ) 

IF  KEY  48  -  DUP  (  NORMAL  IZE  COMI4AND  FROM  ASCII  TO  INT  ) 
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DUP  0<  NOT  SWAP  NUM_CMND  <  AND  ( CHECK  FOR  LIMITS  ) 

IF  DUP  MIP_CMD  THEN  ( GET  COMMAND  AND  EXECUTE  ) 

ELSE  1  ( 0  FOR  LOOP  CONTROL  ) 

THEN  ( TEST  FOR  "SYSTEM"  COMMAND  ) 

WHILE  ( IF.  NOT  CONTINUE  LOOP  ) 

( EXECUTE  SYSTEM  COP  UTITLIES  ) 

REPEAT ; 

(  Note:  To  stan  the  68HC1 1  off  in  the  MEP  program  from  autostart ) 

(  the  commands;  INTT  and  MIP  must  be  added  to  the  end  ) 

(  of  RESTORE  which  is  the  present  autostart  routine.  CAL  ) 

HEX 

:  MIPESTT 

1  B400  C!  (  SET  MIP  INTERFACE:  FI,  IGO,  INT_OFF ) 

HEX 

CR  RETRIEVING  THE  DICTIONARY  ”  CR  (  START  THE  RESTORE  PROCESS ) 

6104 

200 

6100  @  6102  @ 

CMOVE 

RETRIEVINv  -ORTH  USER  AREA 

6100  @ 

6102(5) 

6104  + 

6  84  CMOVE 

CR  RETRIEVE  STATE  COMPLETE 

INITMIP; 

HEX 

EPROM  CONSTANT  MSTART 


(  Autostan  Store  routine  --  stores  the  starting  address  of  MIPINIT  ) 

( into  the  auto-start  address  of  the  EEPROM.  C.AUTION  +*+  +  +  ***+**♦+  ) 

(  This  must  come  last  in  your  dictionary,  and  make  sure  you  STORE  ) 

(  any  changes  to  the  dictionary  first,  before  doing  this  and  then  ) 


(  START  ADDR.  OF  DlCmONARY  IN  EEPROM  ) 

(  START  ADDR.  OF  DICTIONARY  IN  RAM  ) 

( GET  END  AND  START  OF  RAM  DICT  ) 

(  SUBTRACT  TO  GEF  DICTIONARY  LENGTH  ) 

(  MOV'E  DICTIONARY  ) 

"  CR 

(  GET  THE  RAM  DICT  END  ADDRESS  ) 

(  GFT  THE  RAM  DICT  START  ADDRESS  ) 

(  NOW  W^'VE  GOT  THE  DICTIONARY  LENGTH  ) 
(  ADD  EEDICT  OFFSET  TO  GET  ) 

(  A  DDR  OF  USER  AREA  IN  EEPROM  ) 

{  MOVE  USER  ARF.A  ) 

"  CR 
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( rebooting  the  computer  -- 1  learned  the  hard  way!!! 


) 


:  MSTART! 

EEUNPROT 

A44A  DUP  MSTART  EE-! 

[  ’  MIPINIT  ]  LITERAL  CFA 
DICT-START  - 
EEDICT-START  + 

DUP  MSTART  2+  EE-! 

EEPROT 

CR  AUTOSTART  SEQUENCE  STORED  "  CR  ; 
End  of  MIPIO.FOR 
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8.2  KEOasm? 


Advanced  Technologies  Code 


FORGET  CODE-SUB 
HEX 
100  TIB  ! 
lOOTIB  2-t- ! 

200  DP! 


(  KEO  CAMERA  CODE  ) 

(  ) 

( FORTH  CODE  FOR  CONTROL  OF  THE  KEO  CAMERA.  ) 

( THIS  SOFTWARE  IS  DIVIDED  INTO  ) 


(  KEOASM.FOR  FORTH  ASSEMBLER  CODE  FOR  THE  KEO  CAMERA  SYSTEM  ) 

(  WRITTEN  IN  FORTH  AND  SUPPLIED  BY  NEW  MICROS  INC.  ) 

:  CODE-SUB  [CO.MPILE]  CODE-SUB  (COMPILE]  ASSEMBLER  ;  IMMEDIATE 
ASSEMBLER  DEFINITIONS 
VARIABLE  MODE 
:  ft  00  MODE  !  ; 

;DIR  10  MODE  '  ; 

:  ,X  20  MODE  !  ; 

:  ,Y  120  MODE  !  ; 

;  EXT  30  MODE  !  , 

:  ?#  MODE  @  0=^ ; 

;  ?DIRMODE(^  10  =  ; 

;?,XMODE@  20  =  ; 

;  ?,YMODE@  120=  ; 

:  ?EXT  MODE  @  30  =  ; 

:  MODE-LSB  MODE  @  FF  AND  ; 

;  ERROR  '  ED.  CFA  4A  +  EXECUTE: ; 

:  RANGE-C,  DUP  FFOO  AND  IF  HERE  1+  SWAP  -  DUP  ABS  FFOO  AND 

IF  3  ERROR  THENIHENC,  ; 

;  CPU  <BUILDS  C.  nOES>  C(a)  C.  EXT  ;  (  SINGLE  BYTE  OP-CODE  ) 

:  PG-2-CPU  <BUILDS  C,  DOES>  IS  C.  C®'-  C,  EXT  ;  {  18  AND  SINGLE  BYTE  OP¬ 
CODE  ) 

:  HHLL/LL,  ?EXT  IF  .  ELSE  C,  THEN  EXT  ; 

:  2HHLL/LL,  ?EXT  '.'ft  OR  IF  ,  ELSE  C,  T  HEN  EXT  , 

:  MODE-ADJ,  (  ;i  n  -  -  a  ) 

?EXT  IF  OVER  FFOO  AND  0=  IF  DIR  THEN  THEN  MODE-LSB  OR  C, ; 

:  18, Y  ?,YIF  18  C,  THEN; 

:  SOK?  ?ft  IF  3  ERROR  THEN  . 

:  1112  CPU  <BU1LDS  C,  DOi;.S>  I8,Y  C@  MODE-ADJ.  HHLL/LL,  ; 


:  01 12-CPU  cBUILDS  C.  DOES>  18.Y  SOK?  C@  MODE-ADJ,  HHLL/LL, ; 

:  21 12-CPU  <BUILDS  C,  DOES>  18,Y  C@  MODE-ADJ,  2HKL1VLL. ; 

;  (OP-DD-MM)  18.Y  MODE-LSB  IF  C  OR  THEN  C.  C.  C. ; 

:  OP-RR  <BUILDS  C.  DOES>  C@  C.  RANGE-C,  EXT ; 

:  OP-DD-MM  <BUILDS  C.  DOES>  C@  (OP-DD-MM)  EXT  ; 

:  OP-DD-MM-RR  <BUILDS  C.  DOES>  C@  (OP-DD-MM)  RANGE-C,  EXT ; 
:  CPX,  ?,Y  IF  CD  C.  THEN  8C  MODE-ADJ.  2HHLL/LL. ; 

:  LDX,  ?,Y  IF  CD  C.  THEN  CE  MODE-ADJ.  2HHLL/LL. ; 

;  STX,  ?,Y  IF  CD  C.  THEN  SOK?  CF  MODE-ADJ.  HHU./LL, ; 

:  CPY,  7.x  IF  1 A  ELSE  18  THEN  C.  CC  MODE-ADJ,  2HHLL/LL, ; 

:  LDY.  ?,X  IF  lA  ELSE  18  THEN  C.  CE  MODE-ADJ.  2HHLL/LL. ; 

:  STY.  7.x  IF  1 A  ELSE  18  THEN  C.  SOK?  CF  MODE-ADJ.  HHLULL, ; 

:  CPD.  7.Y  IF  CD  C,  ELSE  1 A  C.  THEN  83  MODE-ADJ.  2HHLLyLL. ; 

00  CPU  TEST. 

01  CPU  NOP. 

02  CPU  IDIV, 

03  CPU  FDIV, 

04  CPU  LSRD, 

05  CPU  ASLD.  05  CPU  LSLD, 

06  CPU  TAP, 

07  CPU  TPA. 

08  CPU  INX. 

09  CPU  DEX, 

OA  CPU  CLV. 

OB  CPU  SEV. 

OC  CPU  CLC, 

OD  CPU  SEC. 

OE  CPU  CLI, 

OF  CPUSEI, 

10  CPU  SBA, 

1 1  CPU  CBA. 

12  OP-DD-MM-RR  BRSET, 

13  OP-DD-MM-RR  BRCLR, 

14  0P-DD  MM  BSET, 

15  OP-DD-MM  BCLR, 

16  CPU  TAB. 

17CPUTBA, 

(  18  PAGE  2  ) 

19  CPU  DAA, 

(  lA  PAGE  3  ) 

IB  CPU  ABA. 

(  1C  BSET, 

(  ID  BCLR. 

(  IE  BRSET. 

(  IF  BRCLR, 


2I() 


20OP-RR  BRA. 

21  OP-RR  BRN, 

22  OP-RR  BHI. 

23  OP-RR  BLS. 

24  OP-RR  BCC, 

24  OP-RR  BHS, 

25  OP-RR  BCS, 

25  OP-RR  BLO, 

26  OP-RR  BNE. 

27  OP-RR  BEQ, 

28  OP-RR  BVC. 

29  OP-RR  BVS, 
2A  OP-RR  BPL, 
2B  OP-RR  BMI, 
2C  OP-RR  BGE. 
2D  OP-RR  BLT. 
2E  OP-RR  BGT, 
2F  OP-RR  BLE, 

30  CPU  TSX, 

31  CPU  INS. 

32  CPU  PULA. 

33  CPU  PULB, 

34  CPU  DES, 

35  CPU  TXS, 

36  CPU  PSHA, 

37  CPU  PSHB. 

38  CPU  PULX. 

39  CPU  RTS. 

3A  CPU  ABX, 
3B  CPU  RTI. 

3C  CPU  PSHX, 
3D  CPU  MUL, 
3E  CPU  WAl. 

3F  CPU  SWl, 

40  CPU  NEGA, 
(41  NO 
(42NC) 

43  CPU  COMA, 
44CPULSRA. 

(  45  NC ) 

46  CPU  RORA, 

47  CPU  ASRA, 

48  CPU  ASLA, 

49  CPU  ROLA. 
4A  CPU  DECA, 


( 4B  NC ) 

4CCPU  INCA. 

4D  CPU  TSTA, 

( 4E  NC ) 
4FCPUCLRA, 

50  CPU  NEGB, 
(51NC) 

( 52  NC ) 

53  CPU  COMB. 

54  CPU  LSRB, 

( 55  NC ) 

56  CPU  RORB. 

57  CPU  ASRB, 

58  CPU  ASLB. 

59  CPUROLB. 

5A  CPU  DECB. 

( 5B  NC ) 

5C  CPU  INCB, 

5D  CPU  TSTB. 

( 5E  NC ) 

5FCPU  CURB. 

( 60-7F ) 

40  1112-CPU  NEG, 

43  I112-CPU  COM. 

44  1112-CPU  LSR, 

46  1112-CPU  ROR, 

47  1112-CPU  ASR. 

48  1112-CPU  ASL. 

49  1112-CPU  ROL. 

4 A  1112-CPU  DEC. 
4C  1112-CPU  INC. 
4D  1]12-CPUTST, 
4E  1112-CPlJ  JMP, 
4F  1112-CPU  CLR. 

(  80-BF ) 

801112-CPUSUBA, 

81  1112-CPUCMPA, 

82  1112-CPU  SBCA. 

83  2112-CPU  SUED, 

84  1112-CPU  ANDA, 

85  1112-CPU  BITA, 

86  1112-CPU  LDAA, 

87  0112-CrU  STAA, 

88  1112-CPU  EORA, 

89  1112-CPU  ADCA, 


2\2 


8A1112-CPUORAA, 

8BU12-CPUADDA, 

(8CCPX. 

8D0112-CPUJSR, 

8E2112-CPULDS. 

8F0112-CPUSTS, 

8FCPUXGDX. 

(CO-FF) 

CX)  ni2-CPU  SUBB, 

Cl  1112-CPUCMPB, 

C2  1112-CPU  SBCB, 

C3  2112-CPU  ADDD, 

C4  1112-CPU  ANDB, 

C5  1112-CPU  BITB, 

C61112-CPULDAB, 

C7  0112-CPU  STAB, 

C8  1112-CPU  EORB, 

C9  1112-CPU  ADCB, 

CA  1112-CPU  GRAB, 

CB  1112-CPU  ADDB, 

CC2112-CPULDD, 

CD  0112-CPU  STD. 

(CELDX.) 

( CF  STX, ) 

CF  CPU  STOP, 

08  PG-2-CPU INY, 

09  PG-2-CPU  DEY, 

30PG-2-CPUTSY, 

35  PG-2-CPU  TYS, 

38  PG-2-CPU  PULY, 

3APG-2-CPUABY, 

3CPG-2-CPUPSHY, 

8FPG-2-CPUXGDY, 

8D  OP-RR  BSR, 

:  TOP  ,Y  0  ;  (  ADDRESS  THE  BOTTOM  OF  THE  STACK  *) 

:  SEC  ,Y  2  ;  ( ADDRESS  SECOND  ITEM  ON  STACK  *) 

:  ?EXEC  STATE  (S)  IF  12  ERROR  THEN  ; 

;  7PAIRS  -  IF  13  ERROR  THEN ; 

:  BEGIN,  HERE  1  ; 

:  UNTIL,  7EXEC  >R  1  7PAIRS  R>  C,  HERE  1+  -  C, ; 

:  AGAIN,  21  UNTIL,; 

:  IF,  C,  HERE  0  C,  2  ; 

:  THEN,  7EXEC  2  7PAIRS  HERE  OVER  1+  -  SWAP  C!  ; 

;  ELSE,  2  7PAIRS  HERE  1+  0  BRA, 

SWAP  HERE  OVER  1+- SWAP  C!  2  ; 
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( REVERSE  ASSEMBLY  TEST ) 


:  J^OT.  1  XOR ; 

20CX)NSTANT.FL. 

21  CONSTANT  .TR. 

22  CONSTANT  .LS. 

23  CONSTANT  .HI. 

24CONSTANT.es. 

24  CONSTANT  .LO. 

25  CONSTANT  .CC. 

25  CONSTANT  .HS. 

26  CONSTANT  .EQ. 

27  CONSTANT  .NE. 

28  CONSTANT  .VS. 

29  CONSTANT  .VC. 

2A  CONSTANT 
2B  CONSTANT .++. 

2C  CONSTANT  .LT. 

2D  CONSTANT  .GE. 

2E  CONSTANT  .LE. 

2F  CONSTANT  .GT. 

’  @  CFA  FE43  FE22  -  +  CONSTANT  PUSHD 

’  @  CFA  FE47  FE22  -  +  CONSTANT  NEXTSD 
’  @  CFA  FE47  FE22  -  +  CONSTANT  PUT 
’  @  CFA  FE4A  FE22  -  +  CONSTANT  NEXT 
'  @  CFA  FE4C  FE22  -  +  CONSTANT  NEXT3 
'  @  CFA  FE50  FE22  -  +  CONSTANT  NEXTl 
'  @  CFA  FE52  FE22  -  +  CONSTANT  NEXT2 
'  1+  CFA  FC97  FC7C  -  +  CONSTANT  POP 
'  1+  CFA  FC93  FC7C  -  +  CONSTANT  POPTWO 
0  CONSTANT  W 
2  CONSTANT  TP 
4  CONSTANT  UP 
FORTH  DEHNITIONS 
ASSEMBLER  DEFINITIONS 
:  POPD,  TOP  LDD,  INY,  INY, ; 

;  PUTD,  DEY,  DEY,  TOP  STD, ; 

FORTH  DERNITIONS 

(  PLEASE  DOWNLOAD  KEOROM  FILE ) 


8.3  KEOrom? 


Advanced  Technologies  Code 


(KEOROM,FOR  ) 

(  FORTH  WORDS  FOR  DEALING  WITH  THE  EEPROM  ON  THE  KEO  CONTROL  ) 

(  ) 

(  REVISION  1 :  3.23.91  ) 

(  BROKE  THIS  CODE  OUT  OF  KE06.F0R  ) 


FORGET  SP 


:SP  20 EMIT; 

(  THESE  WORDS  DEAL  WITH  THE  OFF  CHIP  EEPROM  WHERE  WE  STORE  THE  DEFAULT  ) 
(SYSTEM  DICTIONARY  ) 

HEX 


( EEPROT  AND  EEUNPROT  ARE  USED  TO  WRITE  PROTECT  THE  EEPROM  ) 
(  THERE  ARE  SOME  FUNNY  NUMBERS  IN  HERE  WHICH  ARE  HARD  CODED  ) 
(  AND  ASSUME  THAT  THE  EEPROM  STARTS  AT  S6000,  WHICH  IT  DOES  ) 

(  RIGHT  AT  THE  MOMENT.  ) 

(  THE  ADDRESSES  WE  WANT  TO  WRITE  TO,  FROM  THE  CHIPS  POINT  ) 

( OF  VIEW,  ARE  S5555  AND  S2A  AA.  THESE  ADDRESSES  ARE  NOT  ) 

( AVAILABLE  FOR  OUR  EEPROM,  BUT  THE  BOTTOM  14  BITS  MUST  BE  ) 
( REPRESENTING  THESE  ADDRESSES,  SO  WE  WILL  SET  THE  TOP  BIT  ) 

( WHICH  THE  EEPROM  DOES  NOT  EVEN  SEE  AND  WRITE  TO  IT  AT  ) 

( $D555  AND  SAAAA  .  ) 


CODE-SUB  EEPROT 
CE  C,  D5  C,  55  C, 
86  C,  AA  C, 

A7  C,  00  C, 

CE  C,  AA  C,  AA  C, 
86  C,  55  C, 

A7  C,  00  C, 

CE  C,  D5  C,  55  C, 
86  C,  AOC, 

A7  C,  00  C, 

39  C, 

END-CODE 


(LDX  #SD555  1ST  EPROM  ADDRESS  ) 
(LDAA  ^iSAA  1  ST  DATA  PATTERN  ) 
(STAA  0,X  SEND  AN  AA  TO  $5555  ) 

(LDX  #SAAAA  2ND  EPROM  ADDRESS  ) 
(LDAA  «S55  2ND  DATA  PATTERN  ) 
(STAA  0,X  SEND  A  55  TO  S2AAA  ) 
(LDX  #SD555  3RD  EPROM  ADDRESS  ) 
(LDAA  ffSAO  3RD  DATA  PATTERN  ) 
(STAA  0,X  SEND  AN  AO  TO  $5555  ) 

( RTS  RETURN  ) 


CODE-SUB  EEUNPROT 


CE  C, 

D5  C. 

55  C, 

(LDX 

86  C, 

AA  C, 

(LDAA 

A7  C, 

00  C. 

(STAA 

CF- C, 

AA  C, 

AA  C. 

(LDX 

«SD555  1ST  EPROM  ADDRESS  ) 
ifSAA  1  ST  DATA  PATTERN  ) 
O.X  SEND  AN  AA  TO  SD555  ) 

1/SAAAA  2ND  EPROM  ADDRESS  ) 


86  C, 

55  C, 

( 

A7C, 

00  C, 

( 

CEC, 

D5  C, 

55  C, 

( 

86  C, 

80  C, 

( 

A7C. 

00  C, 

( 

CEC, 

D5  C, 

55  C, 

( 

86  C, 

AA  C. 

( 

A7C, 

00  C, 

( 

CEC, 

AA  C, 

AA  C, 

( 

86  C, 

55  C, 

( 

A7C, 

00  c. 

( 

CEC, 

D5  C. 

55  C. 

( 

86  C, 

20  C, 

( 

A7  C, 

00  C, 

( 

39  C, 

{ 

END-CODE 

LDAA 

#S55 

2ND  DATA  PATTERN 

) 

STAA 

0,X 

SENDA55TO$AAAA 

) 

LDX 

#$D555 

3RD  EPROM  ADDRESS 

) 

LDAA 

#S80 

3RD  DATA  PATTERN 

) 

STAA 

0,X 

SENDAN80TO$D555 

) 

LDX 

#SD555 

4TH  EPROM  ADDRESS 

) 

LDAA 

#SAA 

4TH  DATA  PATTERN 

) 

STAA 

0.x 

SENDANAATO$D555 

) 

LDX 

#SAAAA  5TH  EPROM  ADDRESS) 

LDAA 

#S55 

5TH  DATA  PATTERN 

) 

STAA 

0.x 

SEND  A  55  TO  SAAAA 

) 

LDX 

#SD555 

6TH  EPROM  ADDRESS 

) 

LDAA 

tiS20 

6TH  DATA  PATTERN 

) 

STAA 

0.x 

SEND  A  20  TO  $D555 

) 

RTS 

RETURN  ) 

(  EPROM  REPRESENTS  WHERE  IN  EEPROM  WE  WANT  TO  START  STORING  THE  DICTIONARY ) 
(  WE  WANT  TO  RESERVE  SOME  SPACE  FOR  AUTOSTART  ROUTINES  ETC  SO  WE  START  AT  ) 

( 256  BYTES  ABOVE  THE  ACTUAL  START  OF  THE  EEPROM  OR  $6100  ) 

6000  CONSTANT  EPROM 
6104  CONSTANT  EEDICT-START 
200  CONSTANT  DICT-START 


:  EE-!  2DUP  !  BEGIN  2DUP  @  =  UNTIL  DROP  DROP  ; 

:  EE-C!  2DUP  C!  BEG  IN  2DUP  C@  =  UNTIL  DROP  DROP  ; 

:  EETEST  AFFF  EPROM  DO  AA  I  DUP  .  CR  EE-C!  LOOP  ; 


(  STORE  THE  CURRENT  STATE  OF  THE  FORTH  MACHINE  ) 

(  AND  THE  USER  ADDED  DICTIONARY  TO  EXTERNAL  EPROM  ) 

VARIABLE  PROMLOC 

:  STORE 
EEUNPROT 

EPROM  100  +  PROMLOC  ! 

(WE  WILL  STORE  THE  DICTIONARY  END  ADDRESS  AT  S6100) 
HERE  PROMLOC  (TO  EE-! 


(  INCREMENT  T!  IE  PROM!  OC  POINTER  BY  2  ) 

f’ROMi.orrr/  :>!  i’romi  nc: : 


DICT-START  PROMLOC  @  EE-!  ( WE  WILL  STORE  THE  DICTIONARY ) 

( START  ADDRESS  AT  $6102 ) 


PROMLOC  @  2+  PROMLOC  !  ( POINT  TO  THE  START  OF ) 

( THE  EEPROM  DICTIONARY ) 


STORING  DICTIONARY  "  CR  ( MOVE  THE  DICTIONARY  TO  EEPROM ) 

HERE  DICT-START  DO  (...  ONE  BYTE  AT  A  TIME  ) 

I  C@  PROMLOC  @EE-C! 

PROMLOC®  1+  PROMLOC ! 

LOOP 

STORING  FORTH  USER  AREA  "  CR  ( WE  WILL  STORE  THE  FORTH  USER  ) 
84  6  DO  (  AREA  DIRECTLY  ABOVE  THE  DICT ) 

I  C@  PROMLOC  @  EE-C! 

PROMLOC  @  1+  PROMLOC  ! 

LOOP 

EEPROT 

CR  STORE  COMPLETE  "  CR 
ENDED  AT  "  PROMLOC  @  U.  CR 
EEPROT ; 


HEX 

( REPLACE  THE  CURRENT  STATE  OF  THE  FORTH  MACHINE  ) 

(  USER  ADDED  DICTIONARY  FROM  EXTERNAL  El’ROM  ) 

(RAM  DICT  END  ADDRESS  AT  S6100  ) 

(RAMDICTSTART  ADDRESS  AT  S6102  ) 

(  EE-DICT  STARTS  AT  ADDRESS  S6104  ) 

:  RESTORE 
HEX 

CR  RETRrEVING  THE  DICTIONARY  ”  CR 

6104  (  START  ADDR.  OF  DICTONARY  IN  EEPROM  ) 

200  (■  START  ADDR.  OF  DICTIONARY  IN  RAM  ) 

6100  @  6102  (rt)  {  GET  END  AND  SM  ART  OF  RAM  DICT  ) 

{  SUBTRACT  TO  GET  DICTIONARY  LENGTH  ) 

CMOVE  C  MOVE  DICTIONARY  ) 

PJiTRIEVING  rOR'I'II  USER  AREA  "  CR 
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6100  @  (GET  THE  RAM  DICT  END  ADDRESS  ) 

6102  @  ( GET  THE  RAM  DICT  START  ADDRESS  ) 

(NOW  WE'VE  GOT  THE  DICT  LENGTH  ) 

6104+  ( ADD  EEDICT  OFFSET  TO  GET  ) 

(ADDROFUSERAREAINEEPROM  ) 

6  84  CMOVE  ( MOVE  USER  AREA  ) 


CR RETRIEVE  STATE  COMPLETE  "  CR  ; 
HEX 


:  DICT-CHK  ( END  START  -  ) 

CR 

DOIDUP C@ 

SWAP  EEDKCT-START  +  DICT-START  -  C@  = 

IF 

ELSE 

IDUP.SPC@.SP  (RAMADDR,VAL) 

I EEDKTT-START  +  DICT-START  -  DUP  .S?C@  .S?  ( ROM  ADDR,  VAL ) 

??????  "  CRTHEN 
(ERROR  MSG) 

100  0  DO  LOOP 
LOOP; 

(PLEASE  DOWNLOAD  THE  FILE  KEODSP ) 
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8.4  KEOdsp? 


Advanced  Technologies  Code 


(  KEODSP.FOR  ) 

(  FORTH  WORDS  FOR  DEALING  WITH  THE  DSP  ON  THE  KEO  CAMERA  CONTROLLER  ) 
(  REVISION  I  :  3.23.91  ) 

(  BROKE  TH  IS  CODE  OUT  OF  KE06.F0R  ) 

FORGET  FALSE 

0  CONSTANT  FALSE 
1  CONSTANT  TRUE 


BOOO  CONSTANT  PORTA 
B002  CONSTANT  PIOC 
B004  CONSTANT  PORTB 
BOOS  CONSTANT  PORTC 
BOOS  CONSTANT  PORTCL 
BOOT  CONSTANT  DDRC 
BOOS  CONSTANT  PORTD 
B009  CONSTANT  DDRD 
BOOA  CONSTANT  PORTE 
BOOB  CONSTANT  CFORC 
BOOC  CONSTANT  OCIM 
BOOD  CONSTANT  OCID 
BOOE  CONSTANT  TCNT 
BOlO  CONSTANT  TIC  1 
B012  CONSTANT  TrC2 
B014  CONSTANT  TICS 
B016  CONSTANT  TOC  I 
B018  CONSTANT  T()C2 
BOIA  CONSTANT  TOCS 
BOIC  CONSTANT  TOC4 
BOIE  CONSTANT  TOC5 
B020  CONSTANT  TCTLl 
B021  CONSTANT  TCTL2 
B022  CONSTANT  TMSK I 
B023  CONSTANT  TFLCl 
B024  CONSTANT  TMSK2 
B025  CONSTANT  TFL(J2 
B026  CONSTANl'  PACTL 
B027  CONSTANT  PACNT 


:SET-C-IN  OODDRCC!; 

:SET-C-OUT  FFDDRCC!; 

( BIT  MANIPULA'nONS  ) 

(  MASK-X  LEAVES  TRUE  IF  BIT  X  SET  ELSE  FALSE  ) 

;  MASk-T  r080  AND  ; 

:MASk-^  -^'40  AND; 

:  MASK-J  0u20  AND  ; 

:  MASK-4  0010  AND ; 

:  MASK-3  0008  AND  ; 

:  MASK-2  0004  AND  ; 

:  MASK-1  0002  AND  ; 

;  MASK-0  0001  AND  ; 

( CH-X  CHANGES  ONLY  BIT  X  OF  NUMBER  LEAVING  RESULT  ON  STACK  ) 
:CH.7  FF7PXORNOT; 

:CH.6  FTaFXORNOT; 

CH-S  FFDFXORNOT; 

;CH.4  FFEFXORNOT; 

:  CH-3  FFF7  XOR  NOT  ; 

:  CH.2  FFFB  XOR  NOT  ; 

:CH-1  FFFDXORNOT; 

:  CH-0  FFFE  XOR  NOT ; 

( T-X  MAKES  CERTAIN  BIT  X  IS  TRUE  RECARDLESS  OF  CURRENT  STATE  ) 

:  T-7  DUP  MASK-7  0=  IF  CH-7  THEN  ; 

;T-6  DUP  MASK-6  0=  IF  CH-6  THEN; 

:  T-S  DUP  MASK-5  0=  IF  CH-5  THEN  ; 

:  T-4  DUP  MASK-4  0=  IF  CH-4  THEN  ; 

;  T-3  DUP  MASK-3  0=  IF  CH-3  THEN  ; 

:  T-2  DUP  MASK-2  0=  IF  CH-2  THEN  ; 

:  T-l  DUP  MASK- 1  0=  IF  CH- 1  THEN  ; 

:  T-0  DUP  MASK-0  0=  IF  CH-0  THEN  ; 

( F-X  MAKES  CERTAIN  BIT  X  IS  FALSE  REGARDLESS  OF  CURRENT  STATE ) 
:  F-7  DUP  MASK-7  If  CH-7  THEN  ; 

:  F-C  DUP  MASK-6  IF  CH-6  THEN  ; 

;  F-5  DUP  MASK-5  IF  CH-5  THEN  ; 

:  F.4  DUP  ?»1ASK-4  IF  CH-4  THEN  ; 

F.3  DUP  MASK-3  IF  CH-3  THEN; 

;F-2  DUP  MASK-2  IF  CH-2  THEN; 

;F-1  DUPMASK.-l  IFCH-1  THEN; 

;  F-O  DUP  MASK-0  IF  CH-0  THEN  ; 
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(  ROUTINES  FOR  READD  IG  AND  WRITING  DSD  HOST  CONTROL  AND  HOST  DATA  ) 

:  HB!  PORTC  C!  SET-C-OUT ; 

:  HB@  SET-C-IN  PORTC  C@  ; 

:  HCTL!  PORTB  C! ; 

:  HCTL@  PORTB  C@  ; 

(  ROUTINES  FOR  SETTING  THE  HOST  ADDRESS  ) 

:HA0  HCTL@F-0F-1F-2HCTL!  ; 

:  HAl  HCTL@  T-0  F-1  F-2  HCTL!  ; 

:  HA2  HCTL@  F-0  T-1  F-2  HCTL!  ; 

:HA3  HCTU®  T-0  T-1  F-2  HCTL! ; 

;HA5  HCTL@  T-0  F-l  T-2  HCTL! ; 

:HA6  HCTL(2>  F-0  T-1  T-2  HCTL! ; 

:HA7  HCTL@  T-0  T-1  T-2  HCTL! ; 

( BIT  MANIPULATIONS  OF  THE  HOST  CONTROL  PORT ) 

:  RD-EN  HCTL<a>  T-3  HCTL! ; 

;  WR-EN  HCTL@  F-3  HCTL!  ; 

;  HACK  HCTL@  F-4  HCTL!  ; 

:  E^IT-HOST  00  HB!  F8  HCTL!  ; 

:  DSP-RESET  INTT-HOST  HCTL@  DUP  F-6  HCTL!  T-6  HCTL!  ; 

:  DSP-IROB  INIT-HOST  HCTL(&  DUP  F-7  HCIT!  T-7  HCTL!  ; 

.  DSP-BOOT  INIT-HOST  HCTL@  DUP  F-6  F-7  HCTL!  DUP  T-6  HCTL!  T-7  HCTL! 


DR  DSP-RESET ; 

BOOT  DSP-BOOT ; 

EN-HOST  HCrL@  F-5  HCTL! ; 
DIS-HOST  HCTL(S)  T-5  HCTL!  ; 


:  PULL-RESET  INTT-HOST  HCTL(S)  F-6  HCTL! ; 

.  PULL-IRQB  INIT-HOST  HCTLcS)  H-7  HCTL!  ; 

( ROUTINES  FOR  READING  AND  WRITING  THE  DSPS  INTERNAL  HOST  REGISTERS. 
:  ICR@  HAO  RD-EN  EN-HOST  HB@  DIS-HOST  ;  (  -  ICR  ) 

:ICR!  HAO  WR-EN  HB!  EN-HOST  DIS-HOST;  (BYTE-  ) 

:  CVR@  HA  1  RD-EN  EN-HOST  HB(S  DIS-HOST  ;  (  -  C  VR  ) 

;CVR!  HAl  WR-EN  HB!  EN-HOST  DIS-HOST;  (BYTE  ) 

:  1SR(®  HA2  RD-EN  EN-HOST  HB@  DIS-HOST  ;  (  -  ISR  ) 

:1SR!  HA2WT<-ENHB!  EN-HOST  DIS-HOST;  (BYTE-  ) 

:  RXHt®  R\5  RD-EN  EN-HOST  HB(a)  DIS-HOST  ;  (  -  RXH  ) 

:  RXM@  HA6  RD-EN  EN-HOST  HB@  DIS-HOST  ;  (  -  RXM  ) 

;  RXL<§)  IU7  RD-EN  EN-HOST  HB@  DIS-HOST  ;  (  -  RXL  ) 

:TXH:  HAS  WR-EN  HB!  EN-HOST  DIS-HOST;  (BYTE-  ) 

:TXM!  HA6  WR-EN  HB!  EN-HOST  DIS-HOST;  (BYTE-  ) 
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:  TXL!  HA7  WR  EN  HB!  EN-HOST  DIS-HOST ; 

:CLR-TXH-TXM  OODUPTXH!  TXM! ; 


( BYTE  -  ) 


(  ROUTINES  PC*  INIERTRETING  THE  HOST  REGISTERS ) 


RXDF? 

ISR@  MASK-0 ; 

(LEAVES  TRUE  IF  RXDF  BIT  SET) 

TXDE? 

ISR(2)  MASK-1 ; 

(LEAVES  TRUE  IF  TXDE  BIT  SET) 

HF2? 

ISR@  MASK-3 ; 

(TRUE  IF  HF2  SET) 

HF3? 

ISR@  MASK-4 ; 

(TRUE IF  HF3  SET) 

HRFXJ? 

ISR@  MASK- 7 ; 

(  TRUE  IF  DSP  IS  CALLING  HREQ  ) 

T-HFO 

ICR@  T-3  ICR! ; 

(SETS  HR)  TO  TRUE) 

F-HFO 

ICR@  F-3  ICR! ; 

(  SETS  HFO  TO  FALSE) 

T-HFl 

ICR@T-4ICR! ; 

(  SETS  HFl  TO  TRUE) 

F-HFl 

ICR@  F-4  ICR! ; 

(SETSHFl  TO  FALSE) 

:  DSP-BUSY?  HF2? ; 

:  DSP-WAIT  BEGIN  DSP-BUSY?  0=  UNTIL ; 


:  HV!  ( VECTOR#  • ) 

DUP  IF  <  IF  T-7  CVR! 

ELSE  VECTOR  TOO  LARGE  " 

THEN  ; 


( ROUTINES  FOR  GETTING  FILES  FROM  THE  PC  TO  THE  DSP ) 

:  XLATE  (  ASai-VAl.UE  -  ■  HEX-VALUE ) 

DUP  DUP 

2F  >  SWAP  40  <  AND 
IF30- 

ELSE  DUP  DUP  40  >  SWAP  47  <  AND 
IF37- 

ELSE  CR  . ILLEGAL  CHARACTER  RECEVED  "  CR 
THEN 
THEN; 


VARIABLE  END-ADDR 
VARIABLE  BOT-BUF 
VARIABLE  TOP-BIIF 
HERE  END-ADDR  ! 

2  ALLOT 
HERE  BOT-BUF  ! 

600  ALLOT 
HEPvE  TOP-BUF  ! 

TOP-BUF@  BOT-BUF  (S)  -  CONSTANT  BUF-LENGTH 
:DNLD 
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TOP-BUF@  BOT-BUF  @ 

DOKEYDlJP24=  (IFCHAR  =  -S’  ) 

EF  EMIT  I  1-  END-ADDR  !  LEAVE  { STORE  COUNTER  AS  END  ADDR  LEAVE ) 
ELSE  DUP  20  =  ( DF  ITS  A  SPACE  ) 

IFEMITR>1->R  (PRINT IT  BUT DONT COUNT  IT  ) 

ELSE  DUP  OD  =  ( IF  ITS  A  CR  ) 

IF  EMIT  OA  EMIT  R>  1*  >R  (IX)  CR-LF  DONT  COUNT  IT  ) 

ELSE  DUP  XLATE  10  *  SWAP  EMIT  ( H^E  XLATE  MULT  BY  $10  ) 

ELSE  CR  ."  DSP  NOT  READY  " 

THEN 
UNTIL 
I  c:(a)TXH! 

I  l+C(g>TXM! 

I  2+  02)  TXL! 

3  -t-LOOP  T-HFO ; 


SHOW-REGS  CR 
ICRI®  ICR  =  •  .  CR 

KEY  DUP  XLATE  ROT  I  C!  EMIT 
THEN 
THEN 
THEN 
LOOP 

CR  DOWNLOAD  COMPLETED  " ; 


DSP-DUMP  BEGIN  DSP-BOOT  ISR@  6  =  CVR@  12  =  AND  UNTIL 
END-ADDR  @  BOT-BUF  <S>  DO 
BEGIN  TXDE?  DUP 
IF 

ISR@  ISR  =  " .  CR 
CVR<a  CVR  =  " .  CR 
RXH(2)  RXH  =  " .  CR 
RXM@  RXM  =  " .  CR 
RXL@  RXL  =  " .  CR  ; 

SR  SHOW  REGS  ; 

GO  DSP-BOOT  SR  DSP-DUMP  , 

DSP8@  (  READ  FROM  DSP  -  8  BITS  FROM  RXL  REG  ) 

BEGIN  RXDF?  UNTIL  RXL(q)  ; 

DSP16(a)  (  READ  16  BITS  FROM  DSP  RXM  AND  RXl.  REGISTERS  ) 

BEGIN  RXDF'^  UNTIL  RXM@  FF  "  RXL@  ; 
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:DSP8!  (SEND  8  BITS  TO  DSP  TXL  REGISTER) 

BEGIN  'fXDE?  UNTIL  TXL!  ; 

:  DSP16!  (SEND  16  BITS  TO  DSP  TXM  AND  TXL  REGS) 

BEGIN  TXDE?  UNTIL  DUP  FF  /  TXM!  TXL! ; 

( PLEASE  DOWNLOAD  THE  FILE  KEOADC ) 
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8.5  KEOadc8 


Advanced  Technologies  Code 


( KEOADC  FORTH  CODE  THAT  CONTROLS  THE  ON  BOARD  ANALOG  TO  DIGITAL  CONVERTER ) 
FORGET  ADCfL 

(  ANALOG  TO  DIGITAL  CONVERTER  REGISTERS  ) 

B030  CONSTANT  ADCTL  ( CONVERTER  CONTROL  REGISTER  ) 


B031  CONSTANT  ADRl  ( RESULT  REGISTER  1  ) 

B032  CONSTANT  ADR2  ( RESULT  REGISTER  2  ) 

B033  CONSTANT  ADR3  ( RESULl  REGISTER  3  ) 

B034  CONSTANT  ADR4  ( RESULT  REGISTER  4  ) 


:  SET-SCAN  ADCTL  C@  T-5  ADCTL  C! ;  (SET  CONTINUOUS  CONVERSIONS  ) 

;  SET-NOSCAN  ADCTL  (j@  F-5  ADCTL  C! ;  (SET  SINGLE  CONVERSION  CYCLE  ) 

;  SET-SINGLE  ADCTL  C@  F-4  ADCTL  C!  :  (  SETS  SINGLE  CHANNEL  MODE  ) 

:  SET-CHO  SET-SINGLE  ADCTL  C@  F-0  F-1  F-2  F-3  ADCTL  C!  ; 

:  SET-CHl  SET-SINGLE  ADCTL  C(§>  T-0  F-l  F-2  F-3  ADCTL  C! ; 

:  SET-C(!2  SET-SINGLD  ADCTL  C@  F-0  T-1  F-2  F-3  ADCTL  C! ; 

;  SET-CH3  SET-SINGLE  ADCTL  C@  T-0  T- 1  F-2  F-3  ADCTL  C! . 

:  SET-CH4  SET-SINGLE  ADCTL  C@  F-0 1-l  T-2  F-3  ADCTL  C! ; 

:  SET-CHS  SET-SINGLE  ADCTL  C@  T-0  F-l  T-2  F.3  ADCTL  C!  ; 

:  SET-CH6  SET-SINGLE  ADCTL  F-0  T-1  T-2  F-3  ADCTL  C! ; 

:  SET-CH7  SET-SINGLE  ADCTL  (j@  T-0  T- 1  T-2  F-3  ADCTL  C! ; 

:SET-Ml)LT  ADCTL  C@  T-4  ADCTL  C!  ;  (  PUTS  ADC  IN  MULTIPLEXED  INPUT  MODE  ) 

:  SET-GRPl  SET-MULT  ADCTL  CX®  F-3  F-2  ADCTL  C!  ;(  USE  INPUT GROUPI,CHO-3) 

;  SET-GRP2  SET-MULT  ADCTL  C@  T-3  F-2  ADCTL  C!  ;  (  USE  INPUT  GROUP2,  CH4.7  ) 

:  ADC-DONE?  ADCIL  CX®  MASK-7  ;  (  TRUE  IF  A  CONVERSION  SEOUENCE  IS  COMPLETE  ) 

(  FETCH  THE  RESULTS  OF  THE  CONVERSION  ) 

;ADR1(S)  BEGIN  ADC-DONE?  UNTIL  ADRl  C(®  ;  (  FETCH  #1) 

:ADR2@  BEGIN  ADC-DONE?  UNTIL  ADR2  C:@  ;  (FETCH #2) 

:  ADR3<&  BEGIN  ADC-DONE?  UNTIL  ADR3  C@  ;  (  FETCH  #3  ) 

:  ADR4<^  BEGIN  ADC-DONE?  UNTIL  ADR4  CX®  ;  (  FETCH  #4  ) 

;  4ADC(®  BEGIN  ADC-DONE?  UNTIL 

ADRl  CXS)  ADR2  C@  ADR3  CX®  ADR4  CX®  ;  (  FETCH  THEM  Al.L  ) 

;  ADTEST2  SET-SCAN  100  00  DO  SET-CHO  ADRl(g)  .  CR  LOOP  ; 


( F’LI:ASE  DOWNLOAD  KI  OIIM  ni.F: ) 
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8.6  KEOtim? 


Advanced  Technologies  Code 


(KEOTIM  FORTH  DEFNimONS  FOR  TIMING  STATES  FORKED  CAMERA) 
(  DEHNinONS  OF  STATE  CONSTANTS  FOR  USE  IN  THE  KEO  DSP  CODE  ) 
FORGET  PI _HI 
HEX 

1  CONSTANT  P1_HI  (  %0000000000000001 ) 

0  CONSTANT  PrLO 

2  CONSTANT  P2'’hI  {  %000000000(X)00010) 

0  CONSTANT  P2"lO 

4  CONSTANT  PS^HI  (  %0000000000000100 ) 


0 

CONSTANT  P3  LO 

8 

CONSTANT  to”  HI 

(  %0(XX)000(X)0001(»0 ) 

0 

CONSTANT  TG^LO 

10 

CONSTANT  PdT  HI 

(  %00000000(X)010000 ) 

0 

CONSTANT  PIX“lO 

20 

CONSTANT  LEN  HI 

(  %00000()000010()000) 

0 

CONST  ANT  LEN'lO 

40 

CONSTANT  FEN'HI 

(  ^OOfWOOOOKXXXXX)) 

0 

CONSTANT  FEN'LO 

80 

CONSTANT  SCK“HI 

(  %(X)00000010(X)0000) 

0 

CONSTANT  SCK'lO 

100 

CONSTANT  SW_HI 

(  %0000000100000000 ) 

0 

CONSTANT  SW  LO 

200 

CONSTANT  DCK  HI 

(  %(XX)000I0(XXXXXX)0 ) 

0 

CONSTANT  DCK'lO 

400 

CONSTANT  UCR’hI 

(  %00000l(xx>0000000 ) 

0 

CONSTANT  DCR"lO 

800 

CONSTANT  ADS ‘hi 

(  %0000I0(X)0(XXI0000 ) 

0 

CONSTANT  ADS  LO 

(  PS  VAJ.lJl-:S  ARE  INTERMEDIATE  STATES  FOR  THE  PARALLEL  CI-OCKS  ) 
Pl.  HJ  r2„H(  OR  P3_H1  OR  TG_HI  OR  CONSTANT  PSO 

PLHI  P2.LO  OR  P3_HI  OR  IG.Hl  OR  CONSTANl  PSl 

P1_HI  P2.  LO  OR  P3_LO  OR  TG_LO  OR  CONSTANT  PS2 
Pl.HI  P2_HI  OR  n_LO  OR  TG.LO  OR  CONSTANT  PS3 
PIJO  P2.>M  OR  P3.LO  OR  TG.LO  OR  CONSTANT  PS4 
PI_LO  P2.  HJ  OR  P3_HI  OR  TG_HI  OR  CONSTANT  PS5 

Pl_LO  P2..HJ  OR  P3,HI  OR  rG_HI  OR  CONS!  ANT  PS6 
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Pl.HI  P2_HI  OR  P3_HI  OR  TG.HI  OR  CONSTANT  PS7 
Pl.HI  P2_HI  OR  P3_HI  OR  TG.HI  OR  CONSTANT  PS8 


( PAR_IDLE  IS  THE  STATE  IN  WHICH  TO  LEAVE  THE  PAR.ALLEL  ) 

(  CLOCKS  WHEN  THEY  ARE  NOT  IN  USE  ) 

Pl.HI  P2_HI  OR  P3_HI  OR  TG.HI  OR  CONSTANT  PAR  IDLE 


( SPR  VALUES  ARE  PRELIMINARY  STATES  FOR  SERIAL  PRESCAN  PIXELS  ) 

SCK.HI  SW.LO  OR  PIX.LO  OR  LEN.HI  OR  FEN  JX>  OR  DCK.LO  OR  DCRJLO 
OR  ADS  JX)  OR  CONSTANT  SPRO 

SCK.LO  SW.LO  OR  PDC.LO  OR  LEN.HI  OR  FEN.LO  OR  DCK.LO  OR  DCR.LO 
ORADSJ-OOR  CONSTANT  SPRl 

SCK.LO  SW.LO  OR  PDC.LO  OR  LEN.HI  OR  FEN.LO  OR  DCK.LO  OR  DCR  LO 
OR  ADS.LO  OR  (XINSTANT  SPRl 

SCK.LO  SW.LO  OR  PDC.LO  OR  LEN.HI  OR  FEN.  LO  OR  DCK.LO  OR  DCR.LO 
OR  ADS.LO  OR  CONSTANT  SPR3 

SCK.LO  SW.LO  OR  PIX.LO  OR  LEN.HI  OR  FEN.LO  OR  DCK  LO  OR  DCH^  HI 
OR  ADS  J-0  OR  CONSTANT  SPR4 

SCK.LO  SW.HI  OR  PDC.LO  OR  LEN.HI  OR  FEN.LO  OR  DCK.LO  OR  DCR.LO 
OR  ADS.LO  OR  CONSTANT  SPRS 

SCK.LO  SW.LO  OR  PDC.LO  OR  LEN.HI  OR  FEN.LO  OR  DCK  LO  OR  DCR J.0 
OR  ADS.LO  OR  CONSTANT  SPRd 

SCK.LO  SW.LO  OR  PDC.LO  OR  LEN.HI  OR  FEN.LO  OR  DCK.HI  OR  DCR  LO 
ORADSJ.OOR  CONSTANT  SPR7 

SCK.LO  SW^LO  OR  PIX.LO  OR  LEN.HI  OR  FEN.LO  OR  DCK.LO  OR  DCR.LO 
OR  ADS.LO  OR  CONSTANT  SPRS 

SCK.LO  SW.LO  OR  PDC.HI  OR  LEN.HI  OR  FEN.LO  OR  DCK.LO  OR  DCR.LO 
ORADS.HIOR  CONSTANT  SPR9 


(  SRD  VALUES  ARE  INT.  STATES  FOR  SERIAL  READ  PIXELS 

SCK.HI  SW.LO  OR  PIX.LO  OR  LEN.LO  OR  FEN.LO  OR  DCK.LO  OR  DCR.LO 
OR  ADS.LO  OR  CONSTANT  SRDO 

SCK.LO  SW.LO  OR  PDC.LO  OR  LEN.LO  OR  FEN.LO  OR  DCK.LO  OR  DCR  LO 
OR  ADS.LO  OR  CONSTANT  SRDl 

SCK.LO  SW.LO  OR  PDC.LO  OR  LEN.LO  OR  FEN.LO  OR  DCK  LO  OR  DCR  LO 
OR  ADS.LO  OR  CONSTANT  SRDl 

SCK.LO  SW.LO  OR  PDC.LO  OR  LEN.LO  OR  FEN.LO  OR  DCK  LO  OR  DCR  LO 
OR  ADS.LO  OR  CONSTANT  SRD3 

SCK.LO  SW.LO  OR  PDC.LO  OR  LEN.LO  OR  FEN.LO  OR  DCK  LO  OR  DCR.HI 
OR  ADS.LO  OR  CONSTANT  SRD4 

SCK.LO  SW.HI  OR  PDC.LO  OR  LEN.LO  OR  FEN.LO  OR  DCK.LO  OR  DCR.LO 
OR  ADS.LO  OR  CONSTANT  SRDS 

SCK.LO  SW.  LO  OR  PIX.LO  OR  LEN.l.O  OR  FEN.LO  OR  DCK.LO  OR  DCR.LO 
OR  ADS.LO  OR  CONSTANT  SRIH) 
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SCK_LO  SW.LO  OR  PK.LO  OR  LEN_LO  OR  FEN_LO  OR  DCK_HI  OR  DCR_LO 
OR ADS.LO OR  CONSTANT SRD7 

SCK.LO  SW.LO  OR  PDC.HI  OR  LEN.LO  OR  FEN.LO  OR  DCK.LO  OR  DCR..LO 
OR  ADS.LO  OR  CONSTANT  SRD8 

SCK.IX)  SW.LO  OR  PIX.LO  OR  LEN.LO  OR  FEN.LO  OR  DCK.LO  OR  DCR.LO 
OR  ADS.HI  OR  CONSTANT  SRD9 


( SPST  VALUES  ARE  INT.  STATES  FOR  THE  SERIAL  POSTSCAN  PIXELS  ) 

SCK.HI  SW.LO  OR  PDC.LO  OR  LEN.HI  OR  FEN.LO  OR  DCK.LO  OR  DCR.LO 
OR  ADS J-0  OR  CONSTANT  SPSTO 

SCK.LO  SW.LO  OR  PDC.LO  OR  LEN.HI  OR  FEN.LO  OR  DCK.LO  OR  DCR.LO 
OR  ADS  JX)  OR  CONSTANT  SPSTl 

SCK.LO  SW.LO  OR  PK.LO  OR  LEN.HI  OR  FEN.LO  OR  DCK.LO  OR  DCR.LO 
OR  ADS_LO  OR  CONSTANT  SPST2 

SCK.LO  SW.LO  OR  PK.  LO  OR  LEN.HI  OR  FEN.LO  OR  DCK.LO  OR  DCR.LO 
OR  ADS.LO  OR  CONSTANT  SPST3 

SCK.LO  SW.LO  OR  PK.LO  OR  LEN.HI  OR  FEN.LO  OR  DCK.LO  OR  DCR.LO 
OR  ADS.LO  OR  CONSTANT  SPST4 

SCK.LO  SW.HI  OR  PK.LO  OR  LEN.HI  OR  FEN.LO  OR  DCK.LO  OR  DCR.LO 
OR  ADS  J-0  OR  CONSTANT  SPST5 

SCK.LO  SW.LO  OR  PK.LO  OR  LEN.HI  OR  FEN.LO  OR  DCK.LO  Ok  DCK.LO 
OR  ADS.LO  OR  CONSTANT  SPST6 

SCK.LO  SW.LO  OR  PK.LO  OR  LEN.HI  OR  FEN.LO  OR  DCK.Hl  OR  DCR.LO 
OR  ADS  J-0  OR  CONSTANT  SPS17 

SCK.LO  SW.LO  OR  PIX.HI  OP  LEN.HI  OR  FEN.LO  OR  DCK.LO  OR  DCR.LO 
OR  ADS.LO  OR  CONSTANT  SPST8 

SCK.LO  SW.LO  OR  PK.LO  OR  LEN.HI  OR  FEN.LO  OR  DCK.LO  OR  DCR.LO 
OR  ADS.HI  OR  CONSTANT  SPST9 


(  SER.IDLE  IS  THE  STATE  lO  LEAVE  THE  SERIAL  CONTROL  BITS  IN  WHEN  NOT  IN  USE 
SCK.LO  SW.LO  OR  PK.LO  OR  LEN.HI  OR  FEN.LO  OR  DCK.LO  OR  DCR.LO 
OR  ADS.LO  OR  CONSTANT  SER  IDLE 


(  PSTATES  ARE  RNAL  STATES  FOR  PARALLEL  CLOCKING 
PSO  SER.IDLE  OR  CONSTANT  PSTATEO 
PSl  SER.IDLE  OR  CONSTANT  PSTATEI 
PS2  SER.IDLE  OR  CONSTANT  PSTATE2 
PS3  SER.IDLE  OR  CONSTANT  PSTATE3 
PS4  SER.IDLE  OR  CONSTANT  PSTATE4 
PS5  SER.IDLE  OR  CONSTANT  PSTATES 
PS6  SER.IDLE  OR  CONSTANT  PSTATE6 
PS7  SER.IDLE  OR  CONSTANT  PSTATE7 
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PS8  SER.IDUE  OR  CONSTANT  PSTATE8 


( SPRE  STATES  ARE  FLNAL 
SPRO  PAR_IDLE  OR 
SPRl  PAR_IDLE  OR 
SPR2  PAR_IDLE  OR 
SPR3  PAR.IDLE  OR 
SPR4  PAR.IDLE  OR 
SPR5  PAR_IDLE  OR 
SPR6  PAR_IDLE  OR 
SPR7  PAR_E)LE  OR 
SPR8  PAR.IDLE  OR 
SPR9  PAR_IDLE  OR 


STATES  FOR  SERIAL  PIXEL  PRESCANNING 

CONSTANT  SPREO 

CONSTANT  SPREl 

CONSTANT  SPRE2 

CONSTANT  SPRE3 

CONSTANT  SPRE4 

CONSTANT  SPRE5 

CONSTANT  SPRE6 

CONSTANT  SPRE7 

CONSTANT  SPRE8 

CONSTANT  SPRE9 


( SREAD  SI  ATES  ARE  HN  Al,  STATES  FOR  SERIAL  PIXEL  READING 

SRDO  PAR_IDLE  OR  CONSTANT  SREADO 

SRDl  PAR_IDLE  OR  CONSTANT  SREADl 

SRD2  PAR.IDLE  OR  CONSTANT  SREAD2 

SRD3  PAR_IDLE  OR  CONSTANT  SREAD3 

SRD4  PAR_IDLE  OR  CONSTANT  SREAD4 

SRD5  PAR..IDLE  OR  CONSTANT  SREAD5 

SRD6  PAR_IDLE  OR  CONSTANT  SREAD6 

SRD7  PAR.IDLE  OR  CONSTANT  SREAD7 

SRD8  PAR_IDLE  OR  CONSTANT  SREAD8 

SRD9  PAR_IDLE  OR  CONSTANT  SREAD9 


( SPOST  STATES  ARE  RNAL  STATES  FOR  SERIAL.  PIXEL  POSTSCANNING  ) 

SPSTO  PAR_IDLE  OR  CONSTANT  SPOSTO 
SPSTl  PAR_IDLE  OR  CONSTANT  SPOSTl 
SPST2  PAR.IDLE  OR  CONSTANT  SPOST2 
SPST3  PAR_IDLE  OR  CONSTANl' SPOST3 
SPST4  PAR.IDLE  OR  CONSTANT  SPOST4 
SPST5  PARJDLE  OR  CONST \NTSPOST5 
SPST6  PARJDLE  OR  CONSTANT  SPOST6 
SPST7  PAR.IDLE  OK  CONSTANT  SPOST7 
SPST8  PARJDLE  OR  CONSTANT  SPOST8 
SPST9  PAR.IDLE  OR  CONSTANT  SPOST9 

( TSTATES  ARE  FINAL  STATES  FOR  Cl.OCKJNG  TEST  DATA  ) 

PAR.IDLE  SCK_HI  OR  SW_H1  OR  PIX_LO  OR  LENJH  OR  FEN_HJ  OR  DCK.HI 
OR  CONSTANT  TSTATEO 

(  PLEASE  IXJWNLOAD  KEOCMD  RLE  ) 
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8.7  KEOcmd?  Advanced  Technologies  Code 

(  KEOCMD  FORTH  CODE  FOR  KEO  CAMERA  COMMANDS  ) 

( CONST.\NTS  FOR  COMMAND  VECTORS  ) 

92  CONSTANT  CMD_STATES 

93  CONSTANT  CMD“fORMAT 

94  CONSTANT  CMD'CLEAR 

95  CONSTANT  CiMS)~PF. AD 

96  CONSTANT  CMD“1'EST 


( FORTH  WORDS  TO  HANDLE  STATE  DOWNLOADING  ) 

;  ESTT-STATES 
CR 

DSP-WArr  DSP  READY  "  CR 
CLR-TXH-TXM 
CMD.STATES  CVR! 

SPREO  DSP16!  SPREl  DSP16!  SPRE2  DSP16!  SPRE3  DSP16! 

SPRE4  DSP16!  SPRE5  DSP16!  SPRE6  DSP16!  SPRE7  DSP16! 

SPRE8  USP16!  SPRE9  DSP16! 

SREADO  DSP16!  SREADl  DSP16!  SREAD2  DSP16!  SREAD3  DSP16! 
SREAD4  DSP16!  SREAD5  DSP16!  SREAD6  DSPi6!  SREAD7  DSP16! 
SREAD8  DSP16!  SREAD9  DSPI6! 

SPOSTO  DSP16!  SPOSTl  DSP16!  SPOST2  DSP16!  SPOST3  DSP16! 
SPOST4  DSP16!  SPOST5  DSP16!  SPOST6  DSP16!  SPOST7  DSP16! 
SPOST8  DSP16!  SPOST9  DSP16! 

PSTATE0DSP16!  PSTATEl  DSP16!  PSTATE2  DSP16!  PSTATE3  DSP16! 
PS7  ATE4DSP16!  PSTATE5  DSP16!  PSTATE6  DSP16!  PSTATE7  DSP16! 
PSTATE8  DSP16! 

TSTATEO  DSP16! 

STATES  DOWNLOADED"  CR  ; 

(  FORTH  WORDS  TO  HANDLE  FORMAT ) 

VARIABLE  SLENGTH 
VARIABLE  PLENGTH 
VARIABLE  SBINNUM 
VARIABLE  PBINNUM 
VARIABLE  SPRESCAN 
VARIABLE  SPOSTSCAN 
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VARIABLE  PPRESCAN 
VARIABLE  PPOSTSCAN 
VARIABLE  SREADLEN 
VARIABLE  PREADLEN 


( INITIALIZE  FORMAT  PARAMETERS  TO  DEFAULTS  ) 

DECIMAL 

516  SLENGTH  ! 

516  PLENGTH  ! 

1  SBINNUM! 

1  PBINNUM ! 

20  SPRESCAN! 

0  SPOSTSCAN ! 

0  PPRESCAN ! 

0  PPOSTSCAN ! 

516  SREADLEN ! 

516  PREADLEN! 


:  INIT-FORMAT 
DSP-WAIT 
CLR-TXH-TXM 
CMD.FORMAT  CVR! 

SLENGTH  @DSP16! 
PLENGTH  (S)DSP16! 
SBINNUM  @DSP16! 
PBINNUM  @DSP16! 
SPRESCAN  @  DSP16! 
SPOSTSCAN  @  DSP  16! 
PPRESCAN  @  DSP  16! 
PPOSTSCAN  @  DSP16! 
SREADLEN  @  DSP16! 
PREADLEN  @  DSP  16! 

. "  FORMAT  INITIAI-IZED  "  CR  ; 


( WORDS  TO  DEAL  WITH  THE  COUNTER,  USEFUL  FOR  TI^4]NG  THINGS  ) 

( TWATT  WATTS  A  GIVEN  NUMBER  OF  COUNTER  TICKS. ) 

( EXPECTS  THAT  NUMBER  ON  THE  STACK  ) 

CODE  TWAIT 

POPD,  TCNT  ADDD,  BEGIN,  TCNT  CPD,  .CS.  UNTIl,,  NEXT  IMP,  END-CODE 
DECIMAL 
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:  MW  AIT  ( W  - )  ( WATT  V/  MILLISECONDS  ) 
0  DO  1870  TWAIT  LOOP ; 

:  DWAJT  ( W  - )  ( WATT  W  DECISECONDS ) 

0  DO  100  MWAIT  LOOP ; 

:SWAn'  (W-)  (WATT  W  SECONDS) 

0  DO  1000  MWAIT  LOOP  ; 


( WORDS  TO  DEAL  WITH  KEO  S  CUSTOM  I/O  INTERFACE  BOARD  ) 

HEX 

( RAM  LOCATION  TO  STORE  LAST  BYTE  SENT  TO  10  CONTROL  REGISTER  ) 

VARIABLE  RAMCTL 

B400  CONSTANT  lOCTL  ( I/O  CONTROL  REGISTER  LOCATION ) 

:CTL!  (B-)  (WRITES  ABYTE  TO  THE  10  CONTROL  REGISTER) 

DUP  RAMCTL  C!  lOCTL  C! ; 

OCTL!  (INITIO  TO  ZERO.  IS  THIS  OK?) 


( WRITING  TO  BITS  0  I  AND  2  SET  THE  FILTER  WHEEL  POSTION  ) 

;  FW  SET  ( DESIRED-POS'nON  --  ERROR  FLAG.  0  =  OK.  OTHER  =  ERROR ) 


07  AND 

RAMCTL  Q®  OR 
DUP  CTL! 

1  SWAIT 

RAM<rrL  C@  =  NOT  ; 


(  MASK  OFF  OTHER  BITS 
(  MASK  IN  OTHER  BITS  WE  ALREADY  SET 
(STORE IT 

( WAIT  FOR  IT  TO  SWITCH 
( CHECK  IT 


HEX 


:  LATCH!  D800C!; 

:  OPEN  FF  LATCH!  ; 

:  CLOSE  00  LATCH!; 


( WORDS  TO  SET  THE  INTENSIFIER  GAIN  ) 

HEX 
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:  BMT-G AIN-SET  ( DESIRED-GAIN  -  ERROR  FLAG.  0  =  OK.  OTHER  =  ERROR ) 
18  AND 

RAMCTL  C@  OR 
DUP  CTL! 

1  SWAIT 

lOCTL  C@  =  NOT  ; 


10  CONSTANT  LOGAIN 
00  CONSTANT  MIDGAIN 
08  CONSTANT  HIGAIN 


:  LO-GAIN 

LOGAIN  PORTA  C!  ; 

:  MID-GAIN 

MIDGAIN  PORTA  C!  ; 

:  HI-GAIN 

KIGAIN  PORTA  C!  ; 


:  TEST-EN  ( ENABLE  TEST  DATA  THROUGH  INTERFACE  BOARD ) 
PACTL  C@  T-7  PACTL  C!  PORTA  C@  T-7  PORTA  C!  ; 

:  CAM-EN  ( ENABLE  CAMERA  DATA  THROUGH  INTERFACE  BOARD  ) 
PACTL  C(S)  T-7  PACTL  C!  PORTA  C@  F-7  PORTA  C!  ; 


:  SHADE  ( GENERATE  A  TEST  PATTERN  ) 

TEST-EN  DSP- WAIT  CMD_TEST  CVR'  DSP- WAIT  ; 

:READ  (READ  OUT  THE  CCD) 

CAM-EN  DSP- WAIT  CMD_READ  CVR!  DSP- WAIT  ; 

:  CLEAR  ( CLEAR  THE  CCD  ONCE ) 

DSP- WAIT  CMD_CLEAR  CVR!  DSP-WAIT  ; 

:  BIAS  (  READ  OUT  A  BIAS  FRAME ) 

CLOSE  CLEAR  CLEAR  CLEAR  READ  ; 


( WORDS  TO  PERFORM  DARK  FRAME  ACQUISI  HON  ) 
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:  MDARK  (  W  - )  (  W  MILLISECOND  DARK ) 
CLOSE  CLEAR  MWAIT  READ  ; 

:  DDARK  ( W  - )  (  W  D^OSECOND  DARK  ) 
CLOSE  CLEAR  DWAIT  READ  ; 

:  SDARK  ( W  - )  ( W  SECOND  DARK ) 
a  OSE  CLEAR  SWAIT  READ  ; 


(  WORDS  TO  PERFORM  EXPOSURE  FRAME  ACQUISITION ) 

:  MOBS  (  V.'  - )  {  W  MILLISirOND  OBSERVATION  ) 

CLOSE  CLEAR  OPEN  MWAIT  CLOSE  1  DWAIT  READ  ; 

:  DOBS  (  W  - )  (  \V  DECISECOND  OBSERVATION  ) 

CLOSE  CLEAR  OPEN  DWAIT  CLOSE  1  DWAIT  READ  ; 

:  SOUS  (  W  - )  (  W  SECOND  OBSERVATION  ) 

CLOSE  CLEAR  OPEN  SWAIT  QOSE  I  DWAIT  READ  ; 


(  WORDS  THAT  ARE  USEFUL  FOR  TESTING  HARDWARE  ) 

:  SHADES  BEGIN  SHADE  7TERMINAL  UNTIL  ; 

:  READS  BEGIN  READ  TTERMINAL  UNTIL  ; 

;  CLEARS  BEGIN  CLEAR  TTERMINAL  UNTIL  ; 


.  INTT  DSP-BOOT  SR  DSP-DUMP INTT-STATES  INH’-FORMAT  MID-GAIN  ; 


(  STORE  THE  AUTOSTART  SEQUENCE  AND  THE  CFA  OF  THE  AUTOSTART  WORD  IN 
EXTERNAL  EPROM ) 

EPROM  CONSTANT  ASTART 


ASTART! 

EEUNPROT 

A44A  DUP  ASTART  EE- ! 

1 '  RESTORE  ]  LITERAL  Cf  A 
DICT-START  - 
EEDICT-START  -t- 
DUP  ASTART  2+  EE-! 
EEPROT 


( IINPROTECT  TlX  EEPROM  ) 

{  STORE  THE  AUTOSTART  PATTERN  ) 

(GET  THE  CFA  OF  OUR  AUTOSTART  WORD  ) 

{ DICT  OFFSET  OF  AUTOSTART  WORD  ) 

(  LOCATION  OF  AUTOSTART  WORD  IN  EEPROM  ) 

(  STORE  THAT  AFTER  THE  AUTOSTART  PATTERN  ) 
(  PROTECT  7  HE  EEPROM  ) 


CR  AUTOSTART  SEQUENCE  STORED  "  CR  ; 


(  END  OF  KEO  CAMERA  CODE  ) 

(  Please  LOAD  the  KEO  Consultants  Code:  MIP*.FOI  now... ) 
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8.8  FORTH  Directory  Contents 


C:\MIP\FORTH 


8.8.1  Advanced  Technologies  FORTH  Code 

The  following  are  the  FORTH  files  provided  by  Advanced  Technologies  for  their 
controller  board.  These  files  are  listed  above  in  Sections  8.2  through  8.7. 


D  keoadc? 

1301 

9/30791 

1:55:40pni 

□  keoadcS 

1901 

4/13792 

229:48ptT> 

Dkeoajm? 

531S 

9^30/91 

10:52:58»n 

DkeoasmS 

5902 

a^4792 

11:06:12«n 

Q  keoemd? 

6047 

8/24792 

1223:a2pfT) 

Q  keodsp? 

7210 

9/30791 

1&54:04am 

D  keoforp? 

6626 

9vG0791 

1054:38^ 

Pi  keotim? 

6954 

S/X791 

10;55;22am 

8.8.2  Advanced  Technologies  DSP  Code 


The  following  are  the  DSP56001  files  provided  by  Advanced  Technologies.  These  files 
are  all  the  files  associated  with  the  development  of  the  downloaded  DSP  code  and  are 
provided  for  reference  only.  The  DSP  Assembler  and  Simulator  programs  are  Macintosh 
based.  All  development  for  the  DSP  code  was  done  on  Macs. 


INTEQU.ASM: 

lOEQU.ASM: 

KEO*.ASM 

KEO*.LOD 

KEO*.LST 

KEO*.DSP 


D  ntequ  asm 

1112 

9730/91 

1056: 54am 

Q  ioeqaasm 

8978 

9730/91 

10:57:1 6am 

0  keo7  asm 

16106 

9/30/91 

10:58:0<«n 

Q  keoS.asm 

18391 

10/2/91 

4:11:18pm 

Q  keo7.d$p 

2399 

9/30>^ 

10,56:30am 

D  keo8  dsp 

3164 

10/2/91 

4:12:28pm 

□  keo7.lod 

3046 

9/30y^1 

10.58:46am 

□  ksoBlod 

3206 

1072/91 

411  46pm 

D  keo7.lst 

32540 

5/22/91 

9.51:50am 

Q  keoS.bt 

34831 

10/2/91 

4:11:46pm 

DSP  Interrupt  Equates  (provided  by  Motorola) 

DSP  I/O  Equates  (provided  by  Motorola) 

DSP  Assembler  code  (developed  by  Adv.  Tech) 

DSP  Binary  code  --  outputted  from  DSP  Assembler 
DSP  code  Listing  -  outputted  from  DSP  Assembler 
DSP  Binary  code  --  reformatted  to  be  downloaded  to  controller 
I*  This  is  the  file  that  is  used  with  the  DNLD  command  */ 
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8.8.3  KEO  Consultants  FORTH  Code 


The  following  list*'  the  main  controller  FORTH  code  wrinen  by  KEO  Consultants  for  use 
with  the  MIP  and  HAARP  imagers.  Versions  are  chronological  and  all  versions  are 
provided  lor  reference.  The  latest  version  number  should  always  be  the  version 
downloaded  on  the  the  controller's  EEPROM.  The  code  listing  for  MIPIO.FOR  is 
provided  in  Section  8. 1 


Q  m^.fcM 

ZX£ 

5/22/91 

6:04:20pin 

0  mjpOZfof 

6471 

5>78/91 

5:1922t)«n 

G  mip03  f0( 

8810 

7/1/31 

124842pm 

0  mip04  lor 

10842 

10713/91 

124220pm 

0  nvp05.lo( 

11781 

12/20/31 

5:14:20pm 

0  mipOG.Ior 

12089 

7/1/32 

11:48:54m 

0  fnio07.fof 

12424 

9715/92 

1223  08pm 

0  mip08  for 

14687 

10713/92 

ia3O.04<m 

0  mip09  for 

15573 

10719/92 

3.26  28pm 

0  miplO.fof 

16054 

7/23/93 

11.47  54jm 

8.8.4  KEO  Consultants  FORTH 

Utilities 

The  following  utilities  were  written  by  KEO  Consultants  to  assist  in  the  development  and 
testing  of  the  camera  electronics  and  control  system: 

TESTFW.FOR 

TESTSH.FOR 

TESTADC4.FOR 

These  utilities  can  be  downloaded  to  the  controller  by  sending  them  as  a  text  file  using 
Microcsqfi's  TERMINAL  program  provided  witli  Windows  3.1.  When  opening 
TERMINAL,  open  the  HAARP.TRM  configuration  file.  To  get  to  the  FORTH 
environment  (terminating  the  MIP  command  LOOP),  type  a  '0<cr>'.  The  FORTH 
identifier  should  appear.  Hit  <cr>  a  few  times  to  confirm  communication.  The  FORTH 
system  should  return  an  'OK'  for  each  <cr>  entered. 

TESTFW.FOR;  Contains  utilities  to  test  the  performance  of  the  filterwheel.  There 
are  quite  a  few  dictionary  words  defined  in  this  file  but  most  are  words  that  are  used  in  the 
two  main  functions: 

<ddd>  TEST_FILPOS  <ddd>  =  repetition  time  in  deciseconds  on  stack 

<ppp>  TIME_FW  <PPP>  =  target  position  (1-5)  on  stack 

TEST_FILPOS  sets  up  a  loop  to  automatically  test  all  filter  move  posibilities.  Each 
move  returns  a  status  line  that  gives  the  MOVE  type,  the  TARGet  position,  the  number  of 
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20msec  intervals  it  took  to  make  the  move  or  the  ERRor  retxim  code,  the  PRESent 
position,  and  the  cycle  number.  This  program  is  terminated  by  hitting  any  key.  It  will  take 
up  to  5  nx>vcs  to  terminate,  however.  Upon  termination,  TEST_FILPOS  will  report  all 
the  enx>r  tallies  for  this  session.  An  example  of  running  this  program  would  be: 


50  nsT  rzLPOs 


MV 

1  + 

TARG: 

3 

#: 

28 

PRES : 

3 

NUM: 

1 

MV 

2- 

TARG: 

1 

«: 

37 

PRES: 

1 

NUM: 

2 

MV 

1- 

TARG: 

5 

«: 

21 

PRES: 

5 

NUM: 

3 

MV 

2+ 

TARG: 

2 

•  : 

36 

PRES: 

2 

NUM: 

4 

MV 

1- 

TARG: 

1 

«: 

26 

PRES: 

1 

NUM: 

5 

MV 

1  + 

TARG: 

2 

TO 

TE 

PRES: 

4 

NUM: 

6 

MV 

2- 

TARG: 

2 

TO 

TE 

PRES: 

4 

NUM: 

7 

MV 

1- 

TARG: 

3 

I: 

25 

PRES: 

3 

NUM; 

e 

MV 

2  + 

TARG: 

5 

#: 

38 

PRES: 

5 

NUM: 

9 

MV 

1- 

TARG: 

4 

#; 

27 

PRES: 

4 

NUM: 

10 

NUMBER  OF  MOVES:  10 
NUMBER  OF  TIMEOUTS:  2 
NUMBER  OF  POS .  ERRS:  0 
NUMBER  OF  TARGET  ERRORS.  2 
OK 


The  above  example  ran  the  TEST_FILPOS  utilities  using  a  5  second  cycle  time,  and  10 
moves  were  executed  in  which  there  were  two  TO  (timeout)  and  two  TE  (target)  errors. 
These  were  forced  by  setting  the  filtcrwhccl  control  panel  to  manual  and  forcing  a  move  to 
filter  #4.  The  program  waited  I  second  for  the  filter  to  move  from  #1  to  #2  (during  which 
it  moved  .o  #4),  and  reported  a  time  out  error,  and  also  a  target  error,  because  the  Present 
filter  #4  is  not  equal  to  the  Target  filter  #2.  A  Position  error  occurs  when  the  position 
read  from  the  camera  controller  is  not  a  legal  position.  Normally,  during  execution  of 
TEST_FILPOS,  there  should  be  no  errors  of  any  kind. 


TIME_FW  lets  the  user  execute  a  single  mo/e  and  check  the  number  of  loop  cycles  it 
took  to  reach  the  target  filter  position.  The  RET:  code  is  given  to  check  the  execution  of 
the  filter  move.  In  the  example  below,  we  can  see  that  we  moved  from  sonrie  unknown 
position  to  filter  #4,  from  #4  to  #2,  from  #2  to  #3,  and  from  #3  to  #5. 


4 

TIME 

FW 

INDEX: 

27 

RET: 

4 

OK 

2 

TIME_FW 

INDEX: 

35 

RET; 

y 

OK 

3 

TIME  FW 

INDEX; 

26 

RET: 

3 

OK 

5 

TIME 

FW 

INDEX : 

36 

RET: 

5 

OK 

The  time  it  took  for  a  move  is  INDEX  x  .02  .seconds.  Thus; 


Mv;  -2  .70  seconds 

Mv: +1  .52  seconds 

Mv;  +2  .72  seconds 
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The  file  TESTSH.FOR  has  utilities  to  test  the  operation  of  the  camera’s  shutters.  In  the 
file  are  the  following  utilities: 


<deciS6cond>  TEST_SH 
<dGciS6cond>  TEST_BT 
<decisecond>  TSI 
<decisecond>  TS2 
<decisecond>  LGSH 


Opens  and  closes  each  shutter  sequentially 
Opens  and  closes  both  shutters  simultaneously 
Opens  and  closes  Shunerl  (front) 

C^ns  and  closes  Shutter2  (back) 

Opens  and  closes  shutters  sequentially  and  logs  results 


All  of  these  utilties  are  called  with  the  cycle  time  in  deciscconds  on  the  stack.  The  first 
two  utilities  test  both  shutters  terminating  if  an  error  occurs.  Testing  the  shuners  both 
simultaneously  and  sequentially  test  the  robusmess  of  the  shutter  power-supply  and  the 
shutters'  reliability  under  both  conditions.  TSI  and  TS2  are  used  to  test  an  individual 
shutter  for  possible  problems  and  terminate  if  an  error  occurs.  LGSH  is  used  to  test  botli 
shutters  for  long-term  reliability,  reporting  the  results  of  a  long  test  upon  termination  of 
the  test  (by  hitting  any  key).  A  few  examples  follow; 

30  TEST_BT 

ERROR  OPENING  SH2 : 

PROGRAM  TERMINATED  AFTER  3  ITERATIONS  OK 

30  TSI 

ERROR  OPENING  SHI: 

PROGRAM  TERMINATED  AFTER  5  ITERATIONS  OK 
30  LGSH 

ITER  1  ERRl:  C  ERR2 ;  0 
ITER  2  ERRl:  0  ERR2 :  0 
ITEF.  3  ERRl;  0  ERR2 :  0 
ITER  4  ERRl;  0  ERR2 ;  0 
ITER  5  ERRl:  0  ERR2 :  0 
ITER  6  ERRl:  0  ERR2 :  0 
ITER  7  ERRl:  0  ERR2 :  1 
ITER  8  ERRl :  0  ERR2 :  1 
ITER  9  ERRl :  i  ERR2 :  1 
ITER  10  ERRl :  2  ERR2 :  1 
ITER  11  ERRl:  2  ERR2 :  1 
ITER  12  ERRl:  2  ERR2 :  1 
ITER  13  ERRl :  2  ERR2 :  1 
ITER  14  ERRl:  2  ERR2 :  1 

PROGRAM  TERI-IINATED  AFTER  14  ITERATIONS 
SHI  ERRORS:  2  SH2  ERRORS:  1  OK 

In  the  above  examples,  errors  were  forced  by  setting  the  shutters  OPEN  or  CLOSED 
manually  via  the  camera's  control  panel. 


The  file  TESTADC4,FOR  contains  utilities  for  testing  the  camera's  Analog  to  Digital 
Converter  interface.  The  68HC1 1  has  an  8  chaiuiel  multiplexed  ADC  port  that  is  used  by 
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the  camera  to  read  4  temperatures  and  a  photodiode  output.  The  following  utilities 
facilitate  testing  and  calita’adng  these  circuits; 


<ADC  Channel>  RD_CH  Reads  a  channel  four  times  and  takes  an  average 

1  RDjCH 

1:  192  2:  192  3:  192  4:  192  TOTAL:  768  AVERAGE  192 

<ADC  Chann8l>  TST_RD  Executes  RD_CH  once  a  second 


1  TST  RD 


1: 

191 

2 

191 

3: 

192 

4 : 

191 

TOTAL : 

765 

AVERAGE 

191 

1: 

191 

2 

191 

3: 

192 

4  : 

191 

TOTAL : 

765 

AVERAGE 

191 

1: 

192 

2 

192 

3: 

191 

4  : 

192 

TOTAL: 

7  67 

AVERAGE 

191 

CH:1  OK 


<1 0  psec  interval>  RD-AV  Reads  Photodiode  channel  and  gives  an  average. 

The  average  defined  here  is  to  read  the  channel  four 
times,  take  an  average,  wait  <int>xl0^sec,  take 
another  four  readings,  average,  and  do  this  four 
times. 

100  RD-AV 
AVERAGE:  25 

<1 0  psec  interval>  TST-AV  Reads  Photodiode  every  second  giving  the  average 

100  TST-AV 

AVERAGE:  26 
AVERAGE:  26 
CH:  100  OK 


<1 0  psec  interval>  AUTO-AV  Reads  Photodiode  every  second  using  the  pscc 

interval  to  read  it  four  times.  The  average  is 
computed.  If  a  key  is  hit,  the  psec  interval  is 
incremented  and  the  averaging  continues.  To 
terminate  the  program,  a  key  must  be  hit  twice 


25  AUTO-AV 

INTERVAL 

25 

AVERAGE : 

25 

AVERAGE : 

25 

AVERAGE : 

25 

INTERVAL 

26 

AVERAGE : 

26 

A’/ERAGE  : 

25 

AVERAGE ; 

25 

INTERVAL 

27 

AVERAGE : 

26 

AVERAGE : 

25 
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AVERAGE;  24 


INTERVAL:  28 
AVERAGE:  24 
AVERAGE:  26 
AVERAGE:  25 
AVERAGE:  26 
OK 


The  AUTO-AV  utility  is  used  to  check  for  aixl  optimize  the  averaging  period  for  reading 
the  photodiode  voltage.  A  reminder  for  the  ADC  channels: 


CHO:  CCD  Temperature 

CH 1 :  TEC  Temperature 

CH2:  Intensiher  Temperature 

CH3:  Filter  Wheel  Temperature 

Cil4:  Photodiode  Temperature 


8.8.5  Compress  Utility  and  LINKLSTFOR 

COMPRESS.EXE  is  a  DOS  application  Uiat  can  be  run  on  any  FORTH  text  file.  This 
code  was  developed  by  Advanced  Technologies  and  strips  the  text  file  of  any  unnecessary 
characters  thereby  speeding  up  the  downloading  time.  A  compressed'  version  of  the  file  is 
created: 

MIPIO.FOR  —  >  MIPIO.CMP 

E)ownloading  MIPIO.CMP  will  create  exactly  the  same  code  as  MIPIO.FOR. 

LINKLST.FOR  was  a  FORTH  development  idea  to  create  separate  links  in  the  FORTH 
dictionary  that  made  it  impossible  for  the  user  to  use  any  FORTH  words,  except  those 
defined  after  the  Link  was  broken.  The  link  could  later  be  restored.  This  utility  was 
developed  with  the  tliought  of  having  two  different  'environments'  available  to  the  user 
depending  on  their  FORTH  skill  level.  It  was  later  decided  not  to  use  this  approach,  but 
the  code  has  been  left  on  the  HAARP  machine  for  the  interested  FORTHIEl 


240 


Chapter  9  KEO  Hardware  Schematics 


9.1 

Imager  Hardware  Block  Diagram 

242 

9.2 

Interface  Board  Layour 

243 

9.3 

Interface  Board  Schematic 

244 

9.4 

Interface  GAL  Timing  Schematic 
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9.5 

Interface  GAL  Program 

252 

9.6 

CY545  EEPROM  Rev.  3:2 

254 

9.7 

Filter  Wheel  EPROM:  26C16 

255 

9.8 

Control  Panel  I-ayout 

256 

9.9 

Control  Panel  Schematic 

257 

9.10 

Power  I/O  Board  Rev. A  Layout 

262 

9.11 

Power  I/O  Board  Rev. A  Schematic 
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9.12 

Photodiode  Amplifier  Schematic 

265 
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Molhor  Board 


KKO  Consu  1  tdiit,;;  -  -  1  ntor  f  <jcc>  Horjrd  hdyout. 
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Page:  2  of  7 
Engineer:  C.Lance 


ngineer:  C  Lance 
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OUT0.7 


249 


ia»ot 
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DEVICE 

PIN 


KEO  10 

(pal22vl0) 

al5 

* 

1 

al4 

m 

2 

al3 

» 

3 

al2 

c 

4 

all 

ta 

5 

alO 

■■ 

6 

a09 

H 

7 

a08 

cs 

8 

/we 

» 

9 

/oe 

m 

10 

/temp_ 

oe 

= 

/in_oe 

* 

18 

/tmpl_ 

strobe 

c 

/tmp2 

strobe 

■ 

/out  strobe 

s 

in  cTk 

= 

22 

/oc*-  elk 

■ 

(CLK_INPUT  combinatorial) 

(INPUT  combinatorial) 

(INPUT  combinatorial) 

(INPUT  combinatorial) 

(INPUT  combinatorial) 

(INPUT  combinatorial) 

(INPUT  combinatorial) 

(INPUT  combinatorial) 

(INPUT  combinatorial  ) 

(INPUT  combinatorial  ) 

17  (10  combinatorial  active_low) 
(10  combinatorial  active_low)  ~ 

19  (10  combinatorial  active_low) 

20  (10  combinatorial  active_low) 

21  (10  combinatorial  active_iow) 
(10  combinatorial  active_high) 

23  (10  combinatorial  active_low) 


BEGIN 

"Enable  all  final  outputs” 
ENABT ^  (in_oe); 

ENABLE  (in_cl)c)  ; 

ENABLE  (out_Clk); 

ENABLE  (out  strobe) ; 


"  This  PAL  is  used  to  generate  cloc)c  signals  for  a  pair  of  *’ 
"  I/O  latches  on  the  KEO  interface  card  and  is  designed  as  " 
"  per  KEO's  spec.  " 

"  The  address  of  the  latches  is  $B4xx  ” 


"  in__cl)c  is  a  rising  edge  that  latches  data  into  the  input  latch  " 
in_clk  =  al5  •  /al4  *  al3  *  al2  *  /all  *  alO  *  /a09  *  /a08  *  oe  ; 

"  tenp_oe  is  the  an  internal  output  enable  signal  for  the  input  latch  " 
teinp_oe  ■  in_cl)t  ; 

"  in_oe  is  a  delayed  version  of  temp_oe  just  to  be  safe  " 
in_oe  *=  temp_oe  ; 

"  out  elk  is  a  rising  edge  that  latches  data  into  the  output  latch  " 
out_cIk  -  al5  *  /al4  *  al3  *  al2  *  /all  *  alO  *  /a09  *  /a08  *  we  ; 

"  KEO  also  needs  a  strobe  occurring  after  the  output  latch  has  " 

"  been  written  to  and  the  data  has  stabilized.  To  get  this,  without  " 

"  using  a  digital  delay  line,  we  will  rely  on  the  propagation  delay  " 

"  through  the  PAL  3  times,  which  should  be  about  15  ns  each  time.  " 

"  This  will  give  a  delay  of  approx.  45  ns  '' 

"  tmpl_strobe  is  a  delayed  version  of  out_clk  " 
tmpl_strobe  =•  out_clk  ; 

"  tmp2_strobe  is  a  delayed  version  of  tmpl  strobe  " 
tmp2  strobe  =  tmpl_3trobe  ; 

"  out_strobe  is  a  delayed  version  of  tmp2_strobe  " 

"  It  will  occurr  approx  45  n.5  after  out_clk  ’ 

"  This  is  the  signal  to  use  as  output  strob«  " 

out_.strobe  »  tmp2_strobe  ; 
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Device  Map  from  File  (keo_io)  for  PLD  [pal22vl0)* 
FO* 


L0044 

1111 

1111 

1111 

1111 

1111 

1111 

1111 

1111 

1111 

1111 

1111 

* 

L0088 

0111 

1011 

0111 

0111 

1013 

0111 

1011 

1011 

1011 

1111 

1111 

ie 

L0440 

1111 

1111 

1111 

1111 

1111 

1111 

1111 

1111 

1111 

1111 

1111 

* 

LjD484 

0111 

1011 

0111 

0111 

1011 

0111 

1011 

1011 

1111 

1011 

1111 

It 

L0924 

1111 

1111 

1111 

1111 

1111 

1111 

1111 

1111 

1111 

1111 

1111 

it 

L0968 

1111 

1111 

1111 

1110 

1111 

1111 

1111 

1111 

1111 

1111 

1111 

it 

L1540 

1111 

1111 

1111 

1111 

1110 

1111 

1111 

1111 

1111 

1111 

1111 

it 

L2200 

1110 

1111 

1111 

1111 

1111 

1111 

1111 

1111 

1111 

1111 

1111 

★ 

L2904 

1111 

1111 

1111 

1111 

1111 

1111 

1111 

1111 

1111 

1111 

1111 

it 

L2948 

1111 

1111 

1111 

1111 

1111 

1111 

1110 

1111 

1111 

1111 

1111 

it 

L3696 

L5808 

1111 

0111 

1101 

0101 

1111 

0101 

1111 
01  * 

1111 

1111 

1111 

1111 

1111 

1111 

1111 

it 

C3A13* 

9308 
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5  Position  Filter  Wheel  HAARP 


8/19/93 


KEO  Consultants 


CY545  EEPROM  Program  Rev  3:2 
(Half-Stepping  Mode) 

Address  Command  Comrnem 


0 

*RV 

AutoStarl  Code 

3 

O  42H<Cf> 

Operating  Mode  (1200  Baud) 

9 

"<cr><lf>KEO  PROGRAM  08-19-93<cr><l1> 

34 

REV  3:2  C  LANCE<cr><M>* 

52 

/B  4<cr> 

Turn  USRB4  OH  (Enable  Motor) 

57 

F  360<cr> 

First^aeO  (fast  rate  lor  Home) 

63 

R  230<cr> 

Rate«230  (Peak  Velocity) 

69 

S  245<cr> 

Slope=240  (Acceleration) 

1$: 

75 

H  0<cr> 

Home:  Look  at  USRBO 

79 

F  19<cr> 

First=22  (Slow  rate  lor  moves) 

84 

B  4<cr> 

Turn  USRB4  On  (Disable  Motor) 

88 

•W<cr><tf>* 

Wait  Identifier 

2$: 

93 

T01H.093<cr> 

Loop  and  test  for  USRBI  (Move) 

103 

r  2,170<cr> 

Test  USRB2:  If  set,  jmp  to  4$;  V 

111 

"•<cr><ll>'' 

Identifier 

116 

•<cr> 

Set  to  CCW  direction 

118 

T3.149<cr> 

Test  USRB3:  If  set,  Jmp  to  3$:  1  Fitter 

126 

N  1600<.jr><H>* 

'1600  Steps’  Identifier 

136 

N  1610<cr> 

NumSteps  =  1610:  Move  past  Home 

143 

.1 223<cr> 

Jmp  to  6$:  GO  command 

3$: 

149 

•N  800<cr><H>* 

'800  Steps’  Identifier 

158 

N  810<cr> 

NumSteps  =  810:  Move  past  Home 

164 

J  223<;cr> 

Jmp  to  6$:  GO  command 

4$: 

170 

'  +<cr><t(>" 

'+'  Identifier 

175 

•'<cr> 

Set  to  CW  direction 

177 

T  3,208<cr> 

Test  USRB3:  If  set,  jmp  to  5$:  1  Fitter 

185 

“N  1600<cr><lf>* 

'1600  Steps’  Identifier 

195 

N  I590ccr> 

NumSteps  =  1590:  Move  almost  to  Home 

202 

J  223<cr> 

Jmp  to  6$:  GO  command 

5$: 

208 

*N  800<cr><tf>’ 

’800  Steps’  Identifier 

217 

N  790<cr> 

NumSteps  =  790:  Move  almost  to  Home 

6$: 

223 

/B  4<cn 

Turn  USRB4  Off  (Enable  Motor) 

228 

G<cr> 

GO  co.nmand:  Make  move! 

230 

F  360<cr> 

First  =  360:  Fast  Rate  for  Home 

236 

J  75<cr> 

Jump  to  1$:  Home  command 
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EPROM  Program  27C16 


1  oration: 

Output: 

11H 

OH 

BiL _ 0 - 

12H 

3H 

BO:  No  Move  Move 

13H 

7H 

B1:  + 

14H 

5H 

B2;  200  400 

15H 

1H 

OiitDiJt:  Commands: 

21 H 

1H 

OH  No  Move 

22H 

OH 

1H  Move  200  steps -t- 

23H 

3H 

3H  Move  200  steps  • 

24H 

7H 

5H  Move  400  steps  -f 

25H 

5H 

7H  Move  400  steps  - 

31 H 

5H 

32H 

1H 

33H 

OH 

34H 

3H 

35H 

7H 

41H 

7H 

42H 

5H 

43H 

1H 

44H 

OH 

45H 

3H 

51H 

3H 

52H 

7H 

53H 

5H 

54H 

1H 

55H 

OH 

All  other  locations  in  27C1 6  set  to  8H 
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Connector  Side 


Front 


■'ll?  Control  Pn£io]  Lavout 


1 0  s  : 

L  1  i 

and 

Cla  arc  in^joi  red  on  tiie 

hacK  o:  t'ne 

no  a 

rd  di; 

to 

] 

ayout 

uij  6  oi  i.  ')  1101,1.1  ‘..ri  i’c 

rover -Si  d  due 

to 

St  horui 

-  i  c 

i.' 

r  ror , 

KEO  CONSULTANTS  S/N 
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3*62. 463 


'  A  r)  c’ 


F^OWEP  I/(J  Eov.A  lioard  Layout 


'  1  i»  o  o  f  '  ■ 

rs^iis  I 


Air 
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Project:  Powerl/O  board-  REV^ 
title:  24\/  Power  Supply _ 

Signa!  Trantlormer  Date:  8/20/92 


icale:  85%] 
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Chapter  10  Advanced  Technologies  Schematics 
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Image  Hardware  Block  Diagram 
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10.2 

Adv.  Technologies  Block  Diagram 

269 

10.3 

Mother  Board  Schematic 

270 

10.4 

68HC1 1  Control  Schematic 

273 

10.5 

Controller  PAL  Program 

276 

10.6 

68HC1 1  Pin  Layout 

277 

10.7 

Signal  Board  Schematic 

278 

10.8 

Clock  Timing  Generator  Schematic 

280 

10.9 

CCD  Interconnect  Assembly 

281 

10.10 

Driver  CCA  Schematic 

282 

10.11 

Analog  Processing  CCA  Schematic 

286 

10.12 

Clock  Power  CCA  Schematic 

288 
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290 

10.14 

TEC  Unregulated  Power  Supply 

291 
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Mother  Board 
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33  £ 
O  CO  o 


n-iaa'JEi? 


§g  ^ 


_ZKUMCUOZZU*0»- 


U:|£|C 


h:  «  5  ? 


!i)  ii 


o'o<° 

g*o5g 
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g  i^o“|ai 


MSiour 
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HBTOHY 


TO  SHEET  2 
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274 


JlDV&MCKD  TKCBW0L0CIK8 


tt4tl  %m  ttSOB 


DEVICE  mis__addr_select_2  (pal  1618) 

PIN 

al5  -  1  (INPUT  combinatorial) 

al4  “  2  (INPUT  combinatorial) 

al3  =  3  (INPUT  combinatorial) 

al2  “  4  (INPUT  combinatorial) 

all  =  5  (INPUT  combinatorial) 

as  “  6  (INPUT  combinatorial) 

€  =  7  (INPUT  combinatorial) 

rd  “  8  (INPUT  combinatorial) 

/reset  «  9  (INPUT  combinatorial) 

sckin  “  11  (INPUT  combinatorial) 

/sckout  =  12  (OUTPUT  combinatorial  active_low) 

/Isel  “  13  (OUTPUT  combinatorial  active_low) 

/ramsel  -  14  (OUTPUT  combinatorial  active__low) 

/romsel  «  15  (OUTPUT  combinatorial  active^low) 

/memdis  =  16  (10  combinatorial  active_lowT 

/oe  =  17  (OUTPUT  combinatorial  active_low) 

/we  =  18  (OUTPUT  combinatorial  active  low) 


BEGIN 

"Enable  all  outputs" 

ENABLE  (sckout); 

ENABLE  (Isel); 

ENABLE  (ramsel); 

ENABLE  (romsel) ; 

ENABLE  (memdis) ; 

ENABLE  (oe) ; 

ENABLE  (we) ; 

"ramsel  =  select  lower  32k" 
ramsel  =»  /al5  *  /reset  *  /memdis; 

"romsel  ■=  select  upper  32K" 
romsel  «  al5  *  /reset  *  /memdis; 

"Isel  -  latch  select  " 

Isel  =  al5  *  al4  *  /al3  *  al2  *  all  *  /rd  *  e  *  /reset; 

"disable  memory  at  DAC  and  internal  register  locations" 

memdis  =  (  al5  *  /al4  *  al3  *  al2  *  /all  )  +  "68HC24  internal  registers" 

(  al5  *  al4  *  /al3  *  al2  *  all  )  +  "LATCH  (Isel)  location" 

(reset);  "disable  on  reset" 

"output  enable" 

oe  =  rd  *  e  *  /reset; 

"write  enable" 

we  *’  /rd  *  e  *  /reset; 

"  Just  an  inverter" 
sckout  -  sckin; 

END. 
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RECOMMENDED  P.  C.  BOARD  PATTERNS 
AND  NUMBERING  SEQUENCE 


It  » 

7 

s 

3 

1 

83 

81 

78 

77  75 

o  o 

O 

o 

o 

o 

O 

O 

O 

O  O 

>2  0 

^3 

O  0 

O 

o 

o 

o 

0 

0 

O 

O 

0  74 

>0 

• 

« 

4 

2 

8* 

82 

80 

78 

14  0 

0  IS 

730 

OT2 

I*  O 

O  17 

71  O 

O  70 

>•  0 

0  H 

**  O 

0  48 

20  O 

O  21 

47  O 

O  44 

220 

O  23 

43  O 

O  44 

2*0 

O  iS 

430 

O  42 

2Jk  O 

O  27 

41  O 

O  4C 

21  O 

O  2» 

59  O 

O  58 

30  O 

O  31 

S7  O 

O  54 

zt, 

38 

■*0 

42 

44 

48 

48 

SO 

S2 

32  0  <0  0 

«>4 

0 

o 

O 

o 

o 

O 

O 

,0  34 

O  O 

O 

o 

O 

o 

0 

O 

O 

O  0 

33  3S 

37 

39 

41 

43 

45 

47 

49 

St  S3 

84  POS. 


4 

4 

2 

44 

42  40 

o 

o 

O 

o 

o  o 

8 

41 

7  0 

0 

o 

O 

O 

o  o 

O  38 

s 

3 

1 

*3 

8  O 

o 

10 

380 

O  37 

II  O 

o 

12 

340 

O  35 

130 

o 

14 

340 

033 

ISO 

o 

14 

320 

O  31 

21 

23 

23 

27 

17  0 

o 

O 

O 

O 

O  O 

O  28 

18 

30 

O 

O 

o 

o 

O  o 

18 

20 

22 

24 

24  28 

44  POS. 


8  7 

5 

3 

1 

47 

45 

43  41 

O  o 

O 

O 

O 

O 

O 

o  o 

10  o 

"o  o 

O 

o 

O 

O 

O 

O  o  O  io 

8 

6 

4 

2 

48 

44 

44 

12  0 

O  13 

58  O 

O  SB 

14  0 

O  15 

57  O 

O  56 

14  O 

O  17 

550 

054 

18  O 

o  »v 

530 

O  52 

20  O 

O  21 

5i  O 

O  50 

22  O 

023 

49  o 

O  48 

2*0 

025 

*7  O 

O  44 

30 

32 

34 

34 

39 

40 

42 

24  e, 

O  O 

21 

O 

O 

O 

O 

0 

°  ®45 

O  44 

O  0 

o 

0 

O 

O 

o 

o  o 

27  29 

31 

33 

35 

37 

39 

41  43 

68 

POS. 

7 

S 

3 

1 

51 

49  47 

o 

o 

O 

o 

O 

O  O 

8  O  ’o 

o 

O 

o 

o 

48 

0  o 

6  44 

4 

4 

2 

52 

so 

10  O  o 

1 1 

45  O 

O  44 

12  O  O 

13 

43  O 

O  42 

1*0  o 

IS 

41  o 

O  40 

1*  o  O  17 

38  O 

0  38 

18  o  O 

18 

37  O 

O  34 

24 

24 

Z8 

30 

o 

c 

0 

O 

o 

o 

°  % 

0  34 

o 

o 

o 

o 

o 

O  O 

21 

23 

25 

27 

28 

31  33 

52  POS. 
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HAARP  DC  Wiring  Diaaram 


HAARP  External  Cable  Pinout  Documentation 


Signal  Name 

From: 

Pin#: 

Ta 

Pin#: 

Wire  pair 

DPO* 

0B44 

13 

HAARP.P1 

A 

green 

OPO- 

0B44 

10 

HAARP.P1 

8 

red 

DPU 

DB44 

32 

HAAHP.P1 

C 

white 

DPI- 

0B44 

31 

HAARP.P1 

D 

red 

DP2+ 

0B44 

34 

HAARP.P1 

E 

blue 

DP2- 

0B44 

33 

HAARP.P1 

F 

red 

DP3+ 

DBr'4 

36 

HAARP.P1 

H 

orarKia 

OP3- 

03^4 

35 

HAARP.P1 

J 

black 

DP4+ 

DB.'4 

38 

HAARP.P1 

K 

brown 

DP4- 

DB44 

37 

HAARP.P1 

L 

black 

DP5+ 

0B44 

40 

HAARP.P1 

M 

yellow 

DPS- 

0B44 

39 

HAARP.P1 

N 

red 

DP6+ 

0344 

42 

HAARP.P1 

P 

white 

DPS- 

0B44 

41 

HAARP.P1 

R 

black 

DP7+ 

DB44 

7 

HAARP.P1 

S 

red 

DP7- 

0844 

5 

HAARP.P1 

T 

black 

DPft4. 

0344 

43 

HAARP.P1 

U 

green 

DP8- 

0844 

9 

HAARP.P1 

V 

black 

DPft+ 

0844 

30 

HAARP.Pl 

w 

blue 

DP9- 

0844 

27 

HAARP.Pl 

X 

black 

DP104- 

0844 

29 

HAARP.Pl 

Y 

greon 

DPIO- 

0844 

26 

■HAARP.Pl 

z 

orange 

DPIU 

0844 

15 

HAAR?  ?1 

a 

brown 

DP11- 

0844 

'9 

HAARP.Pl 

b 

red 

- - - , 

_ ^ _ 

00  U 

22 

HAARP.Pl 

c 

green 

FEN- 

on  -t 

12 

HAARP.Pl 

d 

blue 

LEN+ 

08  4 

23 

HAARP.Pl 

e 

green 

LEN- 

0844 

14 

HAARP.Pl 

1 

brown 

VSCLK4. 

0844 

21 

HAARP.Pl 

a 

orange 

VSCLK- 

0844 

11 

HAARP.Pl 

h 

red 

GNO 

0844 

1 

HAARP.Pl 

k 

white 

GNO 

0844 

44 

HAARP.Pl 

i 

blue 

RCV+ 

089 

9 

HAARP.Pl 

m 

green 

RCV- 

089 

1 

HAARP.Pl 

n 

white 

TRN+ 

069 

2 

HAARP.Pl 

p 

groen 

TRN- 

089 

3 

HAARP.Pl 

q 

yellow 

|Noto:  DB9  setup  for  RS422  boards  using 

1  the  8&B  Efecironics  232CICC  pinouts 
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MIP/HAARP  Cabling  Documentation 
KEO  Consultants 

Internal  Cable:  Rear  Panel  of  Instrument  to 

Interface  controller  cards 

Name  Interface  Brd. _ Rear  Panel  conn. _ ggigri^pair} 


D0+ 

31 

A 

Grn  (red) 

DO* 

32 

B 

Red  (gm) 

D1  + 

36 

C 

Wht  (red) 

D1* 

35 

D 

Red  (whl) 

D2+ 

24 

E 

Blue  (red) 

D2- 

23 

F 

Red  (Blue) 

D3+ 

28 

H 

Org  (BIk) 

D3- 

27 

J 

BIk  (Org) 

D4+ 

14 

K 

Brn  (BIk) 

D4- 

13 

L 

BIk  (Bm) 

D5+ 

18 

M 

Yllw  (Red) 

D5- 

17 

N 

Red  (Yllw) 

D6+ 

11 

P 

Wht  (BIk) 

D6- 

12 

R 

BIk  (Wht) 

D7+ 

16 

S 

Red  (BIk) 

D7- 

15 

T 

BIk  (Red) 

D8+ 

5 

U 

Grn  (BIk) 

D8- 

6 

V 

BIk  (Grn) 

D9+ 

9 

w 

Blue  (BIk) 

D9- 

10 

X 

BIk  (Blue) 

D10+ 

4 

Y 

Grn  (Org) 

D10- 

3 

z 

Org  (Grn) 

D11  + 

8 

a 

Brn  (Red) 

D11- 

7 

b 

Red  (Brn) 

PIXEL  CLK+ 

25 

g 

Org  (Red) 

PIXEL  CLK- 

26 

h 

Red  (Org) 

EOL  CLK+ 

34 

e 

Grn  (Brn) 

EOL  CLK- 

33 

f 

Brn  (Grn) 

EOF  CLK+ 

38 

c 

Grn  (Blue) 

EOF  CLK- 

37 

d 

Blue  (Grn) 

GND 

1 

k 

Wht  (Blue) 

GND 

2 

J 

Blue  (Wht) 
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Name  DSP  Cntrl  Brd. 

Rear  Panel  conn. 

color  f&oair) 

OA(+)/RTX(+) 

1 

m 

Grn  (Wht) 

OA(-)/RTX(-) 

2 

n 

Wht  (Gm) 

IB{+)/TDX(+) 

3 

P 

Grn  (Yllw) 

IB(-)/TDX(-) 

4 

q 

Yllw  (Gm) 

RESET 

5 

SW(+) 

Yllw  (BIk) 

GND 

10 

SW(-) 

BIk  (Yllw) 

Connectors: 

Rear  Panel: 

MIP/HAARP  Computer  iriterface  Cable:  37  PIN  Circular  67  Series  Amphenol 

Internal  i'.’xS':  boards; 

Adv.  Tech  Signal  Board:  AMP  Mod  IV  44  Pin  Double  Row  .1" 

Adv.  Tech  DSP  Cntrl  Board:  AMP  Mod  IV 10  Pin  Double  Row  .1" 
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Signal  CCA  to  Camera  Head  Cable  for  HA  ARP 


CCD  Head 

Measured 

Color 

63  PIN  Circ. 

signal 

P2  -24  Pin  IOC 

P3-  40  Pin  IDC 

PI-1 

AD11 

P3-34 

GREEN/PURPLE 

28  AWG 

PI-2 

DGND 

P2-19 

PURPLE/GREEN 

28  AWG 

PI -3 

AD10 

P3-20 

BROWN/PLRPLE 

28  AWG 

PI-4 

G^D 

P2-19 

PURPLE/BROWN 

28  AWG 

PI-5 

AD09 

P3-36 

BLACK/GREEN 

28  AWG 

PI -6 

DGND 

P2-20 

GREEN/BLACK 

28  AWG 

PI -7 

AD08 

P3-32 

WHITE/BROWN 

28  AWG 

PI-8 

DGND 

P2-20 

BROWNWHITE 

28  AWG 

PI-9 

AD07 

P3-30 

YELLOW/GRAY 

28  AWG 

PI-10 

DGND 

P2-21 

GRAY/YELLOVV 

28  AWG 

PI-11 

CCDTEMP 

P3-6 

PURPLE 

24  AWG 

PI-12 

AD06 

P3-18 

YELLOW/BROWN 

28  AWG 

PI-13 

DGND 

P2-21 

BROWN.'YELLOW 

28  AWG 

PI-14 

ADOS 

P3-40 

BLUEAWHITE 

28  AWG 

PI-15 

DGND 

P2-22 

WHITE/BLUE 

28  AWG 

PI-16 

AD04 

P3-38 

RED/BROWN 

28  AWG 

P1-17 

DGND 

P2-22 

BROWN/RED 

28  AWG 

PI-18 

AD03 

P3-24 

YELLOW/ORANGE 

28  AWG 

Pi-19 

DGND 

P2-23 

ORANGEA'ELLOW 

28  AWG 

PI-20 

AD02 

P3-22 

RED/GRAY 

28  AWG 

PI -21 

DGND 

P2-23 

GRAY/RED 

28  AWG 

PI-22 

AD01 

P3-28 

GRE£^^l^^'HITE 

28  AWG 

P1-23 

DGND 

P2-24 

WHITE/GREEN 

28  AWG 

PI -24 

ADOO 

P3-26 

WHITE/GRAY 

28  AWG 

PI -25 

DGND 

P2-24 

GRAYAA/HITE 

28  AWG 

PI -26 

DCR 

P3-37 

GRAY/PURPLE 

28  AWG 

PI -27 

GAINSEL1 

P3-7 

PURPLE/GRAY 

28  AWG 

PI -28 

ADS 

P3-35 

ORANGE/PURPLE 

28  AWG 

PI -29 

GAINSEL2 

P3-8 

PURPLE/ORANGE 

28  AWG 

PI -30 

TEC+ 

P2-1/P2-2 

PURPLE/YELLOW 

24  AWG 

PI -31 

TEC- 

P2-3/P2-4 

BROWN/BLUE 

24  AWG 

PI -32 

CCDRTD- 

P3-4 

RED 

24  AWG 

PI -33 

CCDRTD+ 

P3-2 

GREEN 

24  AWG 

PI-34 

TECRTD- 

P3-3 

BLUE 

24  AWG 

PI -35 

TECRTD+ 

P3-1 

WHITE/BLACK 

24  AWG 

PI-36 

TECTHMP 

P3-5 

GRAY 

24  AWG 

PI -37 

P2-5 

WHITE 

24  AWG 

PI-38 

ms^m 

P2-7 

YELLOW 

24  AV/G 

PI-39 

AGND 

P2-10 

ORANGE 

24  AWG 

PI-40 

(+)5V 

P2-13 

VIOLET 

24  AWG 

PI-41 

RESET 

P3-39 

BLACK/GRAY 

28  AWG 

P1-42 

DGND 

P2-17 

GRAY/BLACK 

28  AWG 

P1-43 

SCLK1-  IP3-9 

BROWN/BLACK 

28  AWG 

PI-44 

SCLK1+  iP3-10 

BLACK/BROWN 

28  AWG 

PI-45 

SCLK2+  IP3-12 

RED/BLUE 

28  AWG 

PI-46 

SCLK2-  IP3-11 

BLUE/RED 

28  AWG 

PI-47 

SUMWELL-  'P3-15 

RED/GREEM 

28  AWG 

KEO  Consultants 
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Signal  CCA  to  Camera  Head  Cable  for  HAARP 


PI-48 

SUMWELL+ 

P3-16 

GREEN/RED 

28  AWG 

PI -49 

SCLK3- 

P3-13 

BLACK/BLUE 

28  AWG 

P1-50 

SCLK3+ 

P3-14 

BLUE/BLACK 

28  AWG 

PI-51 

PCLKU 

P3-21 

ORANCE/WHITE 

28  AWG 

PI -52 

PCLK1- 

P3-19 

WHITEA5RANGE 

28  AWG 

PI -53 

PCLK3.t. 

P3-29 

RED/ORANGE 

28  AWG 

PI-54 

PCLK3- 

P3-27 

ORANGE/RED 

28  AWG 

PI -55 

TGATE-f 

P3-33 

BLUE/YELLOW 

28  AWG 

PI -56 

TGATE- 

P3-31 

YELLOW/BLUE 

28  AWG 

PI -57 

PCLK2+ 

P3-25 

YELLOW/GREEN 

28  AWG 

PI -58 

PCLK2- 

P3-23 

GREENA'ELLOW 

28  AWG 

PI-59 

DGND 

P2-18 

GRAY 

24  AWG 

PI-60 

WMBSSm 

P2-14 

BLUE 

24  AWG 

PI-61 

(+)15V  |P2-6 

WHITE/RED 

24  AWG 

PI-62 

(-)15V 

P2-8 

BROWN 

24  AWG 

PI-63 

AGND 

P2-12 

WHfTE 

24  AWG 

KEO  Consultants 
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CCD  Head  Internal  Cabling  for  HAARP 


CCD  Head 


63  PIN  Circ 


Internal  GCA's  Color 


J3  -  Analoq  CCA 


J2  -  Driver  CCA 


Wire  Gage 


DAT01  J3-40 


j_L 

14 

ji 

IS 

ji 

16 

£1 

17 

Ji' 

18 

J1 

19 

JI 

20 

JI 

21 

JI 

22 

JI 

23 

JI 

24 

jf 

25 

JI 

26 

JI 

27 

J1 

28 

JI 

29 

JI 

30 

JI 

31 

JI 

32 

JI 

33 

JI 

34 

JI 

35 

J1 

36 

JI 

37 

JI 

38 

JI 

39 

JI 

-40 

DAT02 


DGND 


DAT03 


t>3ND 


DAT04 


DGND 


DAVOS 


DGND 


CCOTEMP 


DAT06 

DGND 


DAI  07 


DGND 


DAT08 


DGND 


DAT09 


DGND 


DAT10 


DGND 


DAT11 


DGND 


DAT  12 


DGND 


DCR 


GAINSEL2 


ADS 


GAINSEL2 


TECi 


TEC- 


CCDRTD- 


CCDRTD-t- 

TECRTD- 


TECRTD+ 


TECTEMP 


IJ5-37 


IJ3-38 


IJ3-36 


J3-39 


J3-34 


J3.35 


J3-3-: 


J3-32 


1J3-6 


iJ3-30 


|J3  33 


IJ3-28 


J3-2ir 


1J3-25 


IJ3-26 


'J3-24 


1J3-27 


IJ3  22 


IJ3-23 


1J3-19 


IJ3-20 


J3.18 


AGND 


iJ3-17 


J3-42 


IJ3-15 


J3-1/J3-4 


IJ3-2/J3-5 


>J3-1 1 


IJ3-14 

b3-8 


IJ3-12 


IJ3-9 


J3-3 


;j3-7 

iJ3-10 


J3-13 


ORANGEA'ELLOW|28  AWG  I 

YELLOW/ORANGE 

28  AWG 

BLACK/BLUE 

28  AWG 

BLUE/BLACK 

28  AWG 

ORANGE/BLACK 

28  AWG 

BLACK/'ORANGE 

28  AWG 

RED/BROWN 

28  AWG 

BROWN/RED 

28  AWG 

WHfTE/GREY 

28  AWG 

GREY/V/HHE 

28  AWG 

orange/red 

24  AWG 

GREEN/BLACK 

28  AWG 

BLACKJGREEN 

28  AWG 

RED/ORANGE 

28  AWG 

orangetred 

28  AWG 

PURPLE/BLUE 

28  AWG 

IBLUE/PURPLE  28  AWG 


RED/BLUE  28  AWG 


BLUEyRED  28  AWG 


BLACK/GREY  |28  AWG 


iGREY/BLACK  28  AWG 


IBLUEyWHITE  |28  AWG 


WHITE/BLUE  28  AWG 


BLACK/BROWN  28  AWG 


BROWN/BLACK  28  AWG 


BROWN/PURPLE  28  AWG 


PURPLE/BROWN  128  AWG 


PURPLE/GREEN  28  AWG 


GREEN/PURPLE  28  AWG 


BROWN/YELLOW  28  AWG 


BLUE/PURPLE 


I  BROWN/WHITE 


jWHITE/BROWN 
I  YELLOW/GRAY 


IGRAY/YELLOW 


iGREY/PURPLE 


lORANGE 


iPURPLE _ 

(GREEN 


BROWN 


BLACK/GRAY 


28  AWG 


24  AWG 


24  AWG 
24  AWG 


24  AWG 


24  AWG 


24  AWG 


24  AWG 


24  AWG 


24  AWG 


24  AWG 
1 28  AWG 


J1-42 

1  DGND  ;J2-2 

GRAY/BLACK 

|28  AWG 

J1-43 

SCi.KI-  ;J2-3 

GRAV/'YELLO'.V 

28  AWG 

KEO  Consultants 
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COD  Head  Internal  Cabling  for  HAARP 


J1-45 

SCLK2+ 

J2-5 

GREEN/RED 

28  AWG 

J1-46 

S^LK2^ 

J2-6 

REO/GREEN 

28  AWG 

J1-47 

SUMWELL- 

J2-7 

VVHfTL'ORANGE 

28  AWG 

J1-48 

SUMWELL+ 

J2-8 

ORANGEAA'HfTE 

28  AWG 

J1-49 

SCLK3- 

J2-9 

BROWNA'ELLOW 

28  AWG 

J1  50 

SCLK3+ 

J2-10 

YELLOW/BROWN 

28  AWG 

J1-51 

PCLKIt- 

J2-11 

WHITE/BROWN 

28  AWG 

J1-52 

PCLK1- 

J2-12 

BROWNAVHITE 

28  AWG 

J1-53 

PCLK3+ 

J2-13 

BLUEAVHITE 

28  AWG 

J1-54 

PCLK3- 

J2-14 

WHITEjBLUE 

28  AWG 

J1-55 

TGA7E+ 

J2-15 

RED/GRAY 

28  AWG 

J1-56 

TGATE- 

J2-16 

GRAY/RED 

28  AWG 

PCLK2+ 

.J2-17 

GREEM^YELLOW 

28  AWG 

PCI.K2- 

J2-18 

YELLOW/GREEN 

28  AWG 

J1-59 

DGND 

J2-24 

GREEN 

24  AWG 

J1-60 

(•*-)5V  iJ2-23 

ORANGE 

24  AWG 

(f)15V  .J2-20 

YELLOW 

24  AWG 

(-)15V  IJ2-22 

iBLUE 

24  AWG 

J1-63 

AGND  fj2-21 

BROWN 

24  AWG 

KEO  Consultantj 
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HAARP  Shutter  Connector  Diagram 


P1  -  Power  Conn. 

Shutter(+)  Pin  4  Red 

Shutter(-)  Pin  1  Black 

Switch(+)  Pin  2  Green 

Switch(-)  Pin  3  Yellow 


Looking  at  Socket 

LEMO  FGG-1B(0.9) 


P2  -  PhOtoDiode  Amplifier  (Back  Shutter  Only) 


PhotoDiode(+) 

Pin  4 

Red 

Analog  Gnd 

Pin  1 

Black 

+15V 

Pin  3 

Yellow 

-15V 

Pin  2 

Green 

Looking  at  Socket 

LEMO  FHG-OB  (0.5) 


HAARP:  Image  Intensifierr/TEC  Power  Cable 


Products  for  Research  Intesifier  Cooler 
Model  #:  TE342RF 
S/N:  18517-92 


SiG 


4 


(Note:  4/93  ••  Products  for  Research  ircorrecily  wired  Iho  HAARP  Intensifier  Cooler,  so  the  cabling  for 
the  HAARP  imager  is  different  than  the  MIP  Imager.  This  documentation  correctly  describes  the 
HAARP  imager.  Unfortunately,  the  twc  Intensifier  coolers  are  not  directly  interchangable  as  a  result  of  this 
mistake.  ) 
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MIP  and  HAARP  Filter  Wheel  Bousing 

Connector  Diagram 


AC(+)  G 

AC(-)  E 

CTL(+)  H 

CTL(-)  S 

T.RTD(+)  N 

T.RTD(-)  B 

T.RTD(S)  C 

RTO{+)  A 

RTD(-)  L 

PC(+)  K 

PC(-)  M 

5V  J 

DGND  T 

F2  P 

FI  D 

FO  R 

HOME  U 


•  T.RTD  connects  to  REX10  ^.-peralure  Controller 

•  RTD  connects  to  the  Amp.  to  G3HC11 

•  PC  refers  to  Photoresistive  Cell 

•  CTL  refers  to  SSR  control  voltage  (12V) 

•  CTL(--)  AND  CTL(-)  {pins  H  &  S]  are  on  the  MIP 
Filterwheel  only. 
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HAARP  Imager 

Filter  Wheel  Cabling 


KEO  Consultants 


Bendix  18  pin 

E 


AC- 

AC+ 


T.RTO-t- 

T.RTD- 

T.RTO.S 


RTD+ 

RTD- 

PC+ 

PC- 

5V 

cxsrjD 

F2 

FI 

FO 

HOfy^ 


Filterwheei 

Connector 


Black  20AWG 


White  20AWG 


Magnacraft 
W231D-12 

SSR 

CTL^  CTL- 

- 31 


Red 
24AWG 


BIk 


_ 

Red  22AWG 

8 

m 

DIk  22AWG 

9 

_£ _ 

Green  22AWG 

_ Li 

AC(N) 


(Wht) 


AC(H) 


Fuse 
1A  SB 


OUT 

OUT* 

RTD* 

RTD- 


AC-  AC* 


HEX 

C100 


RTD.S 

Tamparatura  Cntlr 


Red  22AWG 

1 

Black  22AWG 

HHHBi 

_ 

Blue  22AWG 

HHBH9 

Green  22AWG 

4 

_ 

Ped/Whi  24AWG 

IHH 

BIkAVht  24AWG 

_ 5. 

p 

Rod  24  AWG 

D 

Black  24AWG 

R 

Yellow  24AWG 

9 

G.een  24AWG 

_ Li 

RTD+ 

RTD- 

PC+ 

PC* 

5V 

D3ND 

F2 

FI 

FO 

HOME 


P5 

Control  Panel 

10  pin  .1'  Double  Row 
AMP  ModIV  Conn. 


Updated  5/93 
Cyril  Lance 


11.13  Removing  the  Image  Intensifier  from  the  H AARP  Imager 

In  the  event  that  you  need  to  remove  the  image  intensifier  from  the  HAARP  imager,  the 
following  steps  must  be  taken; 

Unplug  the  Power  to  the  HAARP  imager  FIRST!!! 

(i)  Unplup  the  Filter  Wheel:  E>isconnect  the  filter  wheel  cable  inside  the  imager 
chassis  (18  pin  Bendix  Connector),  and  then  gently  disconnect  the  Stepper  Motor  cable 
from  the  Power  I/O  Board  that  connects  to  the  filtcrwhecl. 

(ii)  Remove  the  Filter  Wheel:  Unsrew  the  four  8-32  socket  heads  at  the  front  of 
the  imager  chassis  (two  per  side)  the  hold  the  filter  wheel  to  the  chassis.  Gently  pull  the 
filter  wheel  away  from  the  chassis.  The  re-imaging  tube  connecting  to  the  front  shutter 
will  come  off  along  with  the  filter  wheel  (this  is  normal). 

(iii)  Remove  the  front  Shutter:  From  inside  the  U-channcl,  rcnrKjve  the  LEMO 
connector  attached  to  the  shutta  (in  between  the  Power  I/O  board  (front)  and  the  TEC 
power  supply).  Remove  the  three  Phillips  head  10-32  screws  and  slide  the  shutter 
assembly  Towards  off  of  the  Cannon  85mm  lens.  A  close-up  lens  will  remain  attached  to 
the  Cannon  lens  as  the  shutter  slides  off. 

(iv)  Rqpwve  Clamera  Head:  Rcnxivc  the  four  8-32  socket  head  screws  holding  the 
camera  to  the  camera  housing.  Disconnect  the  large,  black  AMP  connector  on  the  base  of 
tlie  camera  head  and  slide  the  head  out  the  back  of  the  housing. 

(v)  Remove  the  back  Shutter:  From  inside  the  U-channtl,  remove  the  two  LEMO 
connectors  just  foward  of  the  circuit  card  cage  that  connect  to  the  shutter.  RenK>vc  the 
three  Phillips  head  10-32  screws  and  slide  the  shutter  assembly  backwards. 

(vi)  Remove  the  Intensifier  housing:  From  inside  the  chassis,  remove  the  six  6-32 
socket  head  screws  holding  the  intensifier  housing  in.  These  are  centered  around  the  main 
cooling  fan  (three  to  a  side)  but  two  of  the  foward  screws  arc  tricky  to  remove.  To  make 
the  disassembly  easier,  loosen  the  REX  CIO  Temperature  Controller  and  slide  it  slightly 
out  of  die  conuol  panel  to  gain  more  access  to  tlic  two  screws  undemcatli  it. 
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Once  these  screws  have  been  removed,  the  intensifier  housing  will  pull  off  the 
chassis,  but  there  are  two  internal  connectors  still  attached.  Gently  pull  the  housing  out  as 
far  as  you  can  (around  2")  and  reach  in  (you  might  need  pliers)  and  release  the  two  Bendix 
connectors  to  the  intensifier  housing. 

(vii)  Remove  the  back  cover/relav  lens:  Unscrew  the  eleven  4-40  button  head 
screws  for  the  back  cover/rclay  lens  unit,  and  slide  the  back  assembly  off  of  the  rest  of  the 
housing,  'fhe  intensifier  will  now  be  sticking  out  of  the  housing  about  1". 

(viii)  Slide  the  Intensifier  out  of  housing:  Without  rotating  the  tube,  pull  the  tube 
out  of  the  housing 

Additional  parts  to  the  Intensifier  cooler: 

Intensifier  Mask:  A  thin  Delrin  Mask  inserts  into  the  curvature  lens  housing  directly 
between  the  curvature  lens  and  the  image  intensifier.  To  remove  this  mask,  complete 
steps  (i)  through  (viii)  above,  and  with  a  needle-nose  pliers,  gently  pull  the  mask  out  of  the 
curvature  lens  housing.  It  is  crucial  that  you  remember  the  correct  orientation  of  this 
mask  with  re.spcct  to  the  housing  and  the  cooling  unit.  The  mask  and  the  curvature  lens 
housing  are  lightly  marked  with  a  pencil. 

Curvature  Lens:  To  remove  the  curvature  corrector  lens  from  inside  the  intensifier 
housing,  complete  steps  (i)  through  (viii)  above,  and  then  remove  the  four  2-56  nylon 
screws  holding  the  curvature  lens  assembly  from  inside  the  intensifier  housing.  This  can 
only  be  done  once  the  intensifier  has  been  removed.  The  curvature  lens  housing  should 
be  removed  and  re-installed  with  the  same  orientation  with  respect  to  the  intensifier 
cooler,  as  this  will  preserve  the  alignment  settings  of  the  instrument. 

Cooler  Window:  To  remove  the  cooler  window,  complete  steps  (i)  through  (iv)  above 
and  set  the  housing  down  on  the  bench.  Remove  the  four  6-32  socket  head  screws  from 
the  front  cover  holding  the  intensifier  cooling  unit  from  inside  the  housing  cover.  The 
cooling  unit  will  now  conic  out  of  the  housing.  Remove  the  four  4  40  screws  from  the 
front  of  the  cooling  unit  which  releases  the  window  retaining  plate. 
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